iOS动态Framework含Bitcode打包失败问题求助

我之前也碰到过一模一样的坑，折腾了好半天才找到问题根源，给你梳理几个关键的排查和解决步骤：

1. 必须用Archive/Install Build生成Framework #

这是最容易忽略的核心点！普通的Run或Build操作生成的Framework只会包含Bitcode Marker，而不是归档要求的完整Bitcode，只有通过Archive或者Install构建的版本才会生成符合苹果归档标准的完整Bitcode。

• 操作步骤：打开你的Framework项目，选择菜单栏的Product -> Archive，等归档完成后，从Xcode Organizer里导出Framework，选择「Build for iOS」（或对应你需要的平台），这样导出的包才是带完整Bitcode的合规版本。

2. 统一所有Target的Bitcode配置 #

如果你的Framework项目包含多个Target（比如主Framework Target和测试Target），一定要确保所有Target的Bitcode相关设置完全一致：

• 每个Target的Build Settings中，Enable Bitcode设为YES
• 自定义设置BITCODE_GENERATION_MODE：Debug配置设为marker，Release配置设为bitcode
• Other C Flags/Other C++ Flags/Other Objective-C Flags：Debug添加-fembed-bitcode-marker，Release添加-fembed-bitcode
  别漏了任何一个Target，哪怕是测试Target，不然也可能干扰最终构建结果。

3. 验证Framework是否真的包含完整Bitcode #

导出Framework后，可以用命令行工具验证是否包含完整Bitcode：

otool -l YourFramework.framework/YourFramework | grep __LLVM

如果输出里有多条包含segname __LLVM的结果，说明已经包含完整Bitcode；如果几乎没有输出，那说明还是只生成了Marker，得回去检查构建方式和配置。

4. 检查主项目的Bitcode配置 #

引用Framework的iOS项目也需要对应配置：

• 主项目的Enable Bitcode设为YES
• 归档时确保使用的是Release配置（Debug模式默认用Marker，归档必须用Release）
• 主项目的BITCODE_GENERATION_MODE也要对应设置：Debug为marker，Release为bitcode

5. 清理缓存，从头构建 #

Xcode的缓存经常会搞出各种奇怪的问题，建议：

• 先执行Shift + Command + K清理Build Folder
• 手动删除Derived Data（可以从Xcode偏好设置 -> Locations里找到路径）
• 重新Archive Framework，替换主项目里的旧Framework后，再重新归档主项目

额外注意：第三方依赖的Bitcode #

如果你的Framework依赖了其他第三方库，这些第三方库也必须是带完整Bitcode的版本，不然主项目归档时同样会报错。如果用CocoaPods管理依赖，可以在Podfile里添加以下配置强制开启所有Pod的Bitcode：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['ENABLE_BITCODE'] = 'YES'
      config.build_settings['BITCODE_GENERATION_MODE'] = config.name == 'Debug' ? 'marker' : 'bitcode'
    end
  end
end

内容的提问来源于stack exchange，提问作者ovidiu.developer