TestFlight无法构建App，报错不存在的appuatx.framework版本问题

问题背景 #

项目可正常运行、归档，也能通过Jenkins构建，但提交至TestFlight时失败，报错指向一个不存在的appuatx.framework，提示其MinimumOSVersion为1.0不符合要求（需8.0及以上）。此前曾因存在的ShieldSDK.framework的相同报错修改过其Info.plist，解决后出现当前问题，已尝试移除并重新添加ShieldSDK，无效。

报错信息 #

[15:54:25]: [31mAsset validation failed Invalid MinimumOSVersion. Apps that only support 64-bit devices must specify a deployment target of 8.0 or later. MinimumOSVersion in 'APP_UAT.app/Frameworks/appuatx.framework' is '1.0'. (ID: 6e9f36b1-20c4-41e9-871d-3375d534678b) (90530)
[0m
[15:54:25]: [31mAsset validation failed Invalid Info.plist value. The value for the key 'MinimumOSVersion' in bundle APP_UAT.app/Frameworks/appuatx.framework is invalid. The minimum value is 8.0 (ID: 96078d4c-1e2f-41a9-982d-9449aad05022) (90362)
[0m
[15:54:25]: [31mAsset validation failed Invalid Bundle. The bundle APP_UAT.app/Frameworks/appuatx.framework does not support the minimum OS Version specified in the Info.plist. (ID: c9aa26ab-c818-4497-86cb-b88c845f2b9e) (90208)

解决方案 #

• 清理构建缓存
  1. 关闭Xcode，删除项目的DerivedData文件夹（路径：~/Library/Developer/Xcode/DerivedData）
  2. 清空Jenkins构建节点上的旧归档包、ipa文件，避免残留旧构建产物干扰
• 排查项目中的隐式引用
  1. 打开Xcode项目，进入Build Phases -> Link Binary With Libraries，检查是否有残留的appuatx.framework引用，若有直接移除
  2. 在Build Settings中搜索FRAMEWORK_SEARCH_PATHS和OTHER_LDFLAGS，删除任何包含appuatx.framework的路径或标记
  3. 打开项目根目录的Info.plist，确认没有任何关联appuatx.framework的条目
• 重置依赖管理工具缓存
  1. 若用CocoaPods，先执行pod deintegrate完全移除Pod依赖，再执行pod install重新安装
  2. 删除CocoaPods全局缓存：rm -rf ~/Library/Caches/CocoaPods
• 检查构建脚本逻辑
  查看Jenkins或fastlane等构建脚本，确认是否有自动生成、复制或重命名框架的步骤，排查是否存在命名错误或残留的旧配置（比如之前处理ShieldSDK时留下的异常逻辑）
• 手动验证归档包内容
  手动生成归档包，右键选择「显示包内容」，进入APP_UAT.app/Frameworks目录，确认是否真的存在appuatx.framework（有时可能是构建过程中临时生成的隐藏文件），如果存在，找到其内部的Info.plist，将MinimumOSVersion修改为8.0及以上后重新提交

内容的提问来源于stack exchange，提问作者Noppakun Anantakitthawon