Xcode14编译报unsupported Swift architecture错误的解决方法求助

问题背景 #

切换至Xcode 14构建系统后，Pod框架生成的桥接头文件采用了以下结构：

#if 0
#elif defined(__arm64__) && __arm64__
// Generated by Apple Swift version 5.7 (swiftlang-5.7.0.127.4 clang-1400.0.29.50)
... bridging for arm64
#else
#error unsupported Swift architecture
#endif
#if 0
#elif defined(__x86_64__) && __x86_64__
// Generated by Apple Swift version 5.7 (swiftlang-5.7.0.127.4 clang-1400.0.29.50)
... bridging for x86
#else
#error unsupported Swift architecture
#endif

该头文件的逻辑是两个独立的架构校验块顺序执行，而非互斥分支。这意味着编译单一架构（如仅arm64或仅x86_64）时，未匹配的那个校验块会触发#error，导致编译失败，即使设置ONLY_ACTIVE_ARCH = 0也无法解决。

原因解析 #

Xcode 14搭配Swift 5.7时，生成混合架构Pod框架的桥接头文件机制发生了变化：

• 传统桥接头文件会用#if...#elif...#else的互斥分支覆盖所有支持的架构，仅当所有架构都不匹配时才触发错误。
• 而Xcode 14生成的头文件为每个架构单独生成了一个#if...#else#error块，相当于每个架构都要单独通过校验——但编译单一架构时，必然有一个块的校验不通过，从而触发错误。
• 这种机制是为了更严格地匹配架构对应的桥接代码，但CocoaPods的构建配置如果未同步调整，就会出现冲突。

修复方案 #

1. 同步Pod与主工程的架构配置 #

• 打开Pod项目的Build Settings，确保VALID_ARCHS和ARCHS与主工程完全一致：
  • 真机环境设置为arm64，模拟器环境设置为x86_64（M1/M2芯片模拟器可选arm64，需统一配置）。
• 确保ONLY_ACTIVE_ARCH在Debug模式下设置为YES，仅编译当前目标的活跃架构。

2. 通过Podfile强制统一配置 #

在Podfile中添加post_install钩子，自动为所有Pod设置统一的架构参数，避免手动逐个修改：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      # Debug模式仅编译活跃架构
      config.build_settings['ONLY_ACTIVE_ARCH'] = config.name == 'Debug' ? 'YES' : 'NO'
      # 限定支持的架构列表
      config.build_settings['ARCHS'] = ['arm64', 'x86_64']
      # 移除无效的架构设置（如i386）
      config.build_settings['VALID_ARCHS'] = ['arm64', 'x86_64']
    end
  end
end

修改后执行pod install重新生成Pod项目配置。

3. 彻底清理构建缓存 #

• 执行Cmd+Shift+K清理当前项目的构建缓存。
• 删除Xcode的DerivedData目录（路径：~/Library/Developer/Xcode/DerivedData），避免旧的生成头文件残留。

4. 调整CocoaPods版本（可选） #

部分旧版本CocoaPods（如1.11.x）与Xcode 14的架构处理逻辑不兼容，可尝试：

• 升级到最新稳定版：sudo gem install cocoapods
• 或降级至适配Xcode 14的版本：sudo gem install cocoapods -v 1.12.1

内容的提问来源于stack exchange，提问作者Vitali Kazakevich