iOS归档打包报错bitcode bundle could not be generated问题求助

核心报错 #

ld: bitcode bundle could not be generated because '/Users/varm/Library/Developer/Xcode/DerivedData/sing-gabxhsjrvxvpvidgonszrxilwwga/Build/Intermediates.noindex/ArchiveIntermediates/sing/BuildProductsPath/Release-iphoneos/libSuperpoweredAudioIOS-iphoneos.a(SuperpoweredHome.o)' was built without full bitcode. All object files and libraries for bitcode must be generated from Xcode Archive or Install build for architecture arm64 
clang: error: linker command failed with exit code 1 (use -v to see invocation)

根因 #

Debug 模式默认不校验 Bitcode 完整性，因此可以正常运行；Archive 阶段会强制校验所有链接的静态库、目标文件的 Bitcode 合规性，当前项目开启了 Bitcode，但依赖的libSuperpoweredAudioIOS-iphoneos.a静态库内的目标文件未编译生成完整 Bitcode 段，直接触发链接失败。

解决方案 #

按优先级从高到低操作：

• 重新编译带完整 Bitcode 的 SuperpoweredAudioIOS 静态库
  若从源码编译该音频库，编译 Release 版本时必须添加编译参数-fembed-bitcode（不要使用 Debug 阶段的占位参数-fembed-bitcode-marker，该参数仅生成标记位不包含实际 Bitcode 内容），确保编译架构覆盖 arm64，编译完成后替换项目中原有的旧版 .a 文件。
  可通过终端命令校验静态库 Bitcode 合规性：

  otool -l libSuperpoweredAudioIOS-iphoneos.a | grep __bitcode
  

  命令输出对应架构的__bitcode段才符合要求，无输出则说明静态库仍未携带正确的 Bitcode。
• 若该库通过 CocoaPods 引入，修正 Pod 编译配置
  打开项目 Podfile，在post_install钩子中添加针对该库的编译配置强制开启 Bitcode 生成：

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      if target.name == 'SuperpoweredAudioIOS'
        target.build_configurations.each do |config|
          config.build_settings['BITCODE_GENERATION_MODE'] = 'bitcode'
          config.build_settings['ENABLE_BITCODE'] = 'YES'
        end
      end
    end
  end
  

  修改完成后执行pod install，清空 Xcode DerivedData 缓存后重新执行 Archive。
• 无法获取支持 Bitcode 的库版本时，直接关闭项目 Bitcode 配置
  Xcode 14 及以上版本已默认移除 iOS 端 App 提交的 Bitcode 强制要求，无特殊 Bitcode 需求时可直接关闭该能力：
  1. 打开 Xcode 选中主 Target，进入 Build Settings 页
  2. 搜索Enable Bitcode，将 Release 模式下的值修改为NO
  3. 同步检查 Pods 项目下所有依赖的 Enable Bitcode 配置，统一修改为NO，清理缓存后重新 Archive。

注意：若项目包含 watchOS 端应用，watchOS 应用提交仍要求 Bitcode 合规，该场景下必须使用前两种方案获取合规的带 Bitcode 静态库，不能直接关闭 Bitcode。

内容的提问来源于stack exchange，提问作者Joshi G