背景
在 Xcode 开发中,如果项目引入了仅支持 arm64 架构的第三方 SDK(例如高德地图 SDK),你可能会发现模拟器列表中没有可用的模拟器设备——明明装好了 SDK,却无法在模拟器上编译运行。
造成这个问题的原因是:iOS 26 默认下载的模拟器是 Apple Silicon(arm64)版本,而部分老旧的第三方 SDK 并未适配该架构,导致兼容性异常。
解决方案
整体思路分两步:先移除默认的 Apple Silicon 模拟器,再强制 Xcode 下载通用(Universal)版本的模拟器。
第一步:删除原有的 Apple Silicon 模拟器
进入 Xcode → Settings → Components(或 Platforms 标签页),找到已安装的 iOS 26.0 Simulator,点击右侧的删除按钮将其移除。
第二步:通过命令行下载通用模拟器
打开终端,执行以下命令:
xcodebuild -downloadPlatform iOS -architectureVariant universal
该命令会强制 Xcode 下载包含
x86_64和arm64双架构的 Universal 版本模拟器运行时,从而兼容那些仅支持 arm64 的第三方库。
验证结果
下载完成后,返回 Xcode 的 Settings → Components 页面,确认模拟器版本标注为 Universal:
- ✅ 标注变为
Universal→ 说明下载成功 - ✅ 在模拟器设备列表中重新出现可用设备 → 问题已修复
此时你就可以像往常一样选择模拟器运行和调试项目了。
适用场景
| 场景 | 是否适用 |
|---|---|
| 项目中集成了仅 arm64 的静态库 / framework | ✅ |
| 使用 Apple Silicon(M 系列芯片)Mac | ✅ |
| 第三方 SDK 未提供 x86_64 切片 | ✅ |
| 纯 Swift / SwiftUI 项目无传统静态库依赖 | ❌ 无需操作 |
| iOS 26 之前的旧版 Xcode | ❌ 架构不同,参数可能不适用 |
延伸阅读
- 如果你使用的是 iOS 25 或更早版本的模拟器,请将命令中的
iOS替换为对应平台标识(如iOS 25.0),具体可查阅 Apple 官方文档或xcodebuild -help。 - 对于已完全适配 Apple Silicon 的现代化 SDK,建议优先使用默认的 arm64 模拟器以获得最佳性能。