Xcode 构建 iOS 模拟器时链接 arm64 架构对象文件的解决方案

问题描述

在使用 Xcode 12 及以上版本构建项目时，可能会遇到以下错误：

building for iOS Simulator, but linking in object file built for iOS, for architecture 'arm64'

有时还会伴随以下错误：

Unable to load standard library for target 'arm64-apple-ios11.0'

这个问题通常出现在以下情况：

项目从 Xcode 11 迁移到 Xcode 12+
项目混合使用 Objective-C 和 Swift 代码
使用了包含第三方预编译框架的 CocoaPods
在 Apple Silicon (M1/M2) Mac 上进行开发

根本原因分析

平台与架构的概念

iOS 开发涉及两种平台和两种主要架构：

平台类型：

iOS 设备 (generic/platform=iOS)
iOS 模拟器 (generic/platform=iOS Simulator)

CPU 架构：

arm64（真实设备和 Apple Silicon 模拟器）
x86_64（Intel 芯片模拟器）

Apple Silicon 带来的变化

在 M1/M2 Mac 上，iOS 模拟器实际上运行在 arm64 架构上，而不是传统的 x86_64 架构。这意味着：

Intel Mac：模拟器需要 x86_64 架构
Apple Silicon Mac：模拟器需要 arm64 架构

当第三方库没有为 Apple Silicon 模拟器提供支持时，就会出现架构不匹配的错误。

解决方案

方案一：更新预编译库（推荐）

最优解决方案是更新所有第三方库到支持 Apple Silicon 模拟器的版本：

联系库供应商获取更新的 XCFramework
重建库源码为支持多平台的 XCFramework
使用 lipo -info <路径到二进制文件> 检查库支持的架构

TIP

XCFramework 是苹果推荐的跨平台框架格式，它包含不同平台和架构的独立二进制文件。

方案二：临时排除架构（短期方案）

如果无法立即获得更新的库，可以临时排除模拟器的 arm64 架构：

在项目设置中排除架构：

选择项目 Target → Build Settings → Excluded Architectures
添加 Any iOS Simulator SDK 并设置值为 arm64

在 Podfile 中添加排除设置：

ruby

post_install do |installer|
  installer.pods_project.build_configurations.each do |config|
    config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "arm64"
  end
end

WARNING

此方案只是临时解决方案，会导致无法在 Apple Silicon 模拟器上正常运行，建议尽快更新库。

方案三：使用 Rosetta 模拟器

对于 Apple Silicon Mac，可以使用 Rosetta 模式的模拟器：

在 Xcode 中点击 Product → Destination → Destination Architectures
选择 "Show Both" 显示所有模拟器选项
选择带有 "Rosetta" 标识的模拟器

Rosetta 模拟器选择

方案四：检查所有相关设置

确保以下位置的架构设置一致：

主项目的 Build Settings
所有 Target 的 Build Settings
Pods 项目的 Build Settings
每个 Pod Target 的 Build Settings

DANGER

常见错误是只修改了主项目的设置，但忘记了修改 Pods 项目的设置，导致问题依旧存在。

高级诊断技巧

检查二进制文件架构

使用终端工具检查库文件的架构支持：

bash

# 使用 lipo 检查架构
lipo -info <路径到二进制文件>

# 示例输出：
# Architectures in the fat file: Framework are: x86_64 arm64

区分 FAT 二进制和 XCFramework

FAT 二进制：单个文件包含多个架构
XCFramework：包含按平台组织的多个二进制文件

XCFramework 是更现代的解决方案，不会导致 App Store 提交时的臃肿问题。

最佳实践

优先使用源码头依赖而不是预编译框架
要求库供应商提供 XCFramework 格式的库
定期更新依赖以确保兼容性
避免长期使用架构排除方案，这只是临时解决方案

常见问题解答

Q: 排除 arm64 架构会有什么影响？ A: 在 Apple Silicon Mac 上无法使用原生模拟器，必须使用 Rosetta 模式，性能会有所下降。

Q: 为什么 Release 和 Debug 构建行为不同？ A: Debug 构建只为当前活跃架构构建，节省构建时间；Release 构建需要为所有可能架构构建，确保兼容性。

Q: 如何检查库是否支持 Apple Silicon 模拟器？ A: 使用 lipo -info 或 file 命令检查二进制文件包含的架构，确认包含 arm64 模拟器支持。

总结

Xcode 构建时遇到架构不匹配问题主要源于 Apple Silicon 芯片的架构变化和第三方库更新滞后。长期解决方案是更新所有依赖库到支持多架构的版本，短期可以使用排除架构或 Rosetta 模拟器作为过渡方案。

建议开发团队逐步将项目迁移到完全支持 Apple Silicon 的架构，以提高开发效率和应用性能。

相关文章

Xcode 构建 iOS 模拟器时链接 arm64 架构对象文件的解决方案 ​

问题描述 ​

根本原因分析 ​

平台与架构的概念 ​

Apple Silicon 带来的变化 ​

解决方案 ​

方案一：更新预编译库（推荐） ​

方案二：临时排除架构（短期方案） ​

方案三：使用 Rosetta 模拟器 ​

方案四：检查所有相关设置 ​

高级诊断技巧 ​

检查二进制文件架构 ​

区分 FAT 二进制和 XCFramework ​

最佳实践 ​

常见问题解答 ​

总结 ​