Xcode 12模拟器缺失arm64、X86_64架构报错的解决咨询
问题本质定位
仅模拟器触发的架构缺失报错,根源是Xcode 12调整了模拟器构建的默认架构规则:在Apple Silicon芯片的Mac上,模拟器默认同时构建arm64(M系列芯片原生运行)、x86_64(Intel芯片模拟器、Rosetta转译环境)两类目标架构。校验失败的核心原因,是引入的依赖库仅包含真机运行所需的arm64切片,没有对应的模拟器架构切片。
之前尝试排除架构不生效,大多是因为配置层级错位——根项目的架构配置优先级低于依赖子工程(尤其是CocoaPods拉取的第三方库)的内置编译规则,单独修改根项目的参数覆盖不了依赖自身的构建设置,自然跳不过架构校验。
分步解决操作
1. 修正架构排除规则的生效范围
- 不要全局在根项目配置架构排除,要把规则覆盖到所有参与构建的目标:主App、Watch Extension、所有依赖库target
- 单target配置路径:选中对应目标 → 打开
Build Settings→ 搜索Excluded Architectures→ 给Any iOS Simulator SDK项配置排除值为arm64 - 使用CocoaPods管理依赖的场景,直接在Podfile的post_install脚本里批量给所有Pods子目标配置规则,避免逐个修改出错:
post_install do |installer| installer.pods_project.targets.each do |target| target.build_configurations.each do |config| # 仅对模拟器SDK排除arm64,不改动真机构建的架构配置 config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64' end end end - 注意:
VALID_ARCHS参数在Xcode 12已经被废弃,不会再参与构建流程,不要用这个参数做架构控制,配置后不会产生实际构建效果
2. 无模拟器架构依赖库的适配方案
- 如果依赖库是团队内部可调整的源码库:重新编译全切片的通用二进制包,用
lipo -info 库文件路径校验结果,确保包含四类核心切片:真机arm64、模拟器x86_64、模拟器arm64,从根源上避免架构校验报错 - 如果依赖库是闭源第三方、无法重新编译:
- 在依赖对应的target上配置和上述一致的
EXCLUDED_ARCHS规则,强制构建流程跳过缺失架构的校验 - 提前确认项目最低部署版本不低于iOS 12,避免因架构缺失触发运行时找不到符号的异常
- 在依赖对应的target上配置和上述一致的
3. Apple Watch目标的特殊配置要求
- Watch App本体、Watch Extension都是独立的编译target,需要单独重复一遍上述的
Excluded Architectures配置。很多场景下只改了主App的架构规则,漏掉了Watch端的目标配置,照样会触发构建阶段的架构校验报错 - 不要把Watch目标的架构排除规则写到iPhone主App的配置项里,层级错位的配置完全不起作用
内容的提问来源于stack exchange,提问作者Mr. Singh
相关产品推荐
相关产品推荐

