升级至Xcode 16后Unity作为iOS库编译出现链接错误

• 检查主App目标配置

  • 打开主App的Build Settings，确认Mach-O Type设置为Executable（__mh_execute_header仅在可执行文件中存在）。
  • 确保Other Linker Flags包含-ObjC，保证Unity库能正确链接Objective-C符号。

• 验证Unity Framework集成

  • 确认Unity Framework已添加到主App的Frameworks, Libraries, and Embedded Content，且Embed选项设为Embed & Sign。
  • 检查Unity Framework的Build Settings，Mach-O Type必须是Dynamic Library，不可设为Executable。

• 修复Swift代码中的符号声明
  如果你的UnityService.swift中直接引用了__mh_execute_header，在文件顶部添加外部符号声明：

  extern let __mh_execute_header: UnsafeRawPointer
  

• 切换回旧版链接器
  Xcode 16的新链接器可能存在兼容性问题，在主App的Other Linker Flags中添加-ld_classic，强制使用旧版链接器尝试构建。

• 彻底清理重建

  • 执行Product > Clean Build Folder，再删除项目的Derived Data（路径：Window > Projects > 选中当前项目 > Delete Derived Data）。
  • 重新构建Unity项目，确保生成的Framework仅包含arm64架构（可通过lipo -info [UnityFramework路径]命令验证）。

• 检查架构一致性
  确保主App和Unity Framework的Architectures均设置为arm64，避免混合架构导致链接错误。

• 排查自定义Post Build脚本
  若项目中有Unity Post Build自定义脚本，确认脚本未修改Framework的链接配置或符号表，导致符号无法被解析。

内容的提问来源于stack exchange，提问作者Kevin DiTraglia