症状:Xcode 报 building for iOS Simulator but linking in object file built for iOS, for architecture arm64。
最快解法:先确认报错库是否只有 iOS 真机切片;优先更新供应商提供的 XCFramework,或为自有库重建包含模拟器切片的 XCFramework。
如果你使用 Apple silicon 上的模拟器、依赖预编译二进制或第三方 SDK,这篇适合你;如果报错并未指向依赖库,先检查具体 target 和构建目的地,别直接改全局架构设置。
先按报错锁定目标与依赖
错误里的 iOS Simulator 指当前要构建的目标平台,built for iOS 指链接器读到的二进制属于 iOS 真机平台,arm64 则是 CPU 架构标识。换句话说,报错重点通常不是“arm64 不能用于模拟器”,而是同为 arm64 的二进制来自不同平台,不能因此直接互换。
Apple 的技术说明将这类错误与未更新、缺少 Apple silicon 模拟器支持的预编译库联系起来;对应的修复建议是更新供应商库,或用源码为模拟器重新构建。你可以先对照 Apple 关于 Apple silicon 架构构建错误的说明,再按错误文本记录库名、target 和当前目的地。
如果错误指出的库是 VendorKit.framework,那就先追踪这个库,不要一开始清理整个工程。还要核实当前选的是 iOS Simulator 还是 iOS 真机:scheme、目的地选错时,看到的构建目标和预期并不一致。
平台与架构必须分开判断
平台和 CPU 架构是两种不同维度。arm64 只能说明二进制面向哪种 CPU 指令集,不能证明它是为 iOS 真机还是 iOS Simulator 编译;所以“库里有 arm64”并不等于“库可以被 arm64 模拟器使用”。
检查时可以分两层:
- 看平台切片: 对 XCFramework,检查其
Info.plist中AvailableLibraries对应的SupportedPlatform、SupportedPlatformVariant与SupportedArchitectures。模拟器变体应明确对应 iOS Simulator;只有 iOS 真机条目,仍然不够。 - 看二进制架构: 对内部二进制运行
file,确认其中包含哪些架构。这个结果能帮助定位架构,但不能单独证明平台匹配。Apple 的 XCFramework 创建说明指出,iOS 与 iOS Simulator 的静态库应分开构建,不能只把不同平台的架构片段用lipo合并成一个文件。
若依赖通过 Swift Package Manager 以二进制形式分发,也要确认包内引用的确实是支持目标平台的 XCFramework,而不是只有真机产物的归档包。Apple 的二进制 Swift 包说明解释了二进制目标如何使用 XCFramework;包能成功下载,并不代表其中每个目标平台都具备可链接切片。
按依赖来源选择修复方案
优先级评分(编辑判断,不是性能实测):
- ✅ 更新供应商 XCFramework:★★★★★——适用于第三方 SDK,前提是供应商发布了包含模拟器平台切片的版本。升级后要确认项目实际解析到新产物,而不是旧缓存或另一个重复依赖。
- ✅ 自有库重新构建并打包:★★★★★——适用于你能访问源码的静态库或 framework。分别面向 iOS 真机与 iOS Simulator 构建,再通过 XCFramework 按平台打包。
- ⚠️ 对特定模拟器 SDK 临时排除 arm64:★★☆☆☆——仅适用于依赖确实无法提供模拟器 arm64、且你已经验证替代运行目的地可用的短期过渡。它不会把真机库变成模拟器库,也不是长期修复。
如果供应商提供的是传统 .framework 或 .a,但没有清楚标注支持的平台,先索要与当前依赖版本对应的模拟器产物和构建说明。若库由你们自己维护,就从源码构建两套平台产物,再用 xcodebuild -create-xcframework 打包;构建与打包时应按平台分别提供产物,避免把架构名称误当作平台兼容证明。
EXCLUDED_ARCHS 只适合作为有限的临时绕过
它只能在有限条件下暂时绕过问题。Apple 的建议是:供应商尚未更新库时,可以仅针对模拟器 SDK 排除 arm64,并在取得更新库后撤销设置;这不是获取新库的替代方案。具体设置范围应遵循前文的 Apple 架构构建说明,不要把这个设置复制到所有项目或所有 target。
全局排除容易带来几个后果:真机或其他 target 被一并影响;Apple silicon 模拟器不再按预期构建;团队成员使用不同目的地时得到不一致结果;临时改动长期残留,后来升级依赖也无法及时发现兼容性问题。EXCLUDED_ARCHS 会从目标架构列表中移除指定架构,因此设置范围和继承关系都需要核实,不能只看某个 target 的单一配置值。Xcode 构建设置参考解释了该设置的作用,目标级配置也可能受项目和配置文件中的设置影响。
如果不得不临时排除,先确认它只对 iphonesimulator 生效,不要动真机 SDK;把变更记录在配置文件或任务记录中,明确恢复条件,并分别验证受影响的 target。不要为了绕过错误去改 ARCHS 或恢复旧的 VALID_ARCHS 覆盖项:Apple 的技术说明建议先检查并恢复偏离默认值的架构设置。
按清单完成修复与双目标验收
下面的顺序从定位依赖开始,直到确认真机和模拟器都能链接。每次只改一个变量,避免把“清缓存”“换目的地”和“改架构设置”混在一起,最后无法确认真正的修复原因。
- [ ] 固定复现条件: 记录 scheme、构建配置、运行目的地和完整错误文本,标出报错中的库名及所属 target。
- [ ] 追踪依赖实际来源: 确认库来自供应商二进制、自有静态库,还是源码依赖;同时检查工程中是否存在同名的重复版本。
- [ ] 核验平台切片: 查看 XCFramework 的
Info.plist,区分 iOS 真机与 iOS Simulator 条目;再用file检查内部二进制架构。不能只凭 arm64 字样判定平台兼容。 - [ ] 选择正确修复: 第三方库优先更新到供应商支持模拟器的平台产物;自有库则分别构建真机和模拟器版本,再重新打包 XCFramework。
- [ ] 检查架构覆盖设置: 查看项目、target 和
.xcconfig中的ARCHS、EXCLUDED_ARCHS、VALID_ARCHS。删除无意残留的覆盖;若有临时排除,确认只限定模拟器 SDK,并注明移除条件。 - [ ] 先构建模拟器目标: 选择实际要运行的 iOS Simulator 目的地,重新构建并确认原报错库已正确解析。若仍失败,记录新的错误路径,判断是否还有另一项依赖也缺少对应平台切片。
- [ ] 再构建真机目标: 切换到 iOS 真机目的地单独构建,确认真机依赖没有被模拟器设置误伤。模拟器构建成功不代表真机切片也可用。
- [ ] 保存可复查记录: 记录依赖版本、产物来源、切片检查结果和临时设置的撤销条件,供之后升级工具链或依赖时复核。
真机和模拟器的验收必须分别执行:模拟器能运行,不代表它模拟了真实设备的所有硬件特性;Apple 也建议在适当的物理设备上验证实际运行行为。可参考 Apple 关于在模拟设备或实体设备上运行应用的说明,但本文的链接验收重点仍是两类目的地分别能否正确链接对应平台产物。
如果修复需要临时切换 Mac 或隔离环境,可以先确认远程桌面是否满足你的交互需求;VNC 连接指南介绍了连接方式。只有在需要另一台 Mac 复现同一套依赖和目标构建时,才考虑 SSHMac 的 Mac 租赁环境:它适合独立验证环境,不会替你补齐缺失的模拟器切片;如果你长期运行固定的重负载任务,或必须连接特定物理设备,租赁也未必合适。搭好环境后,按前面的清单分别跑完模拟器与真机构建,再决定是否保留这项临时设置。