解决 Xcode 下载 iOS Simulator 频繁失败的问题

 原创    2024-02-18

从 Xcode 引导安装 iOS Simulator 套件很容易下载失败且无法断点续传,解决办法是直接从 Apple 开发者网站下载文件手动安装。

糟糕的体验

大概是因为开启了 AppStore 的应用自动更新,开发机上的 Xcode 默默地被更新到了最新版本。虽然仅仅是 15.1 到 15.2 的小版本号升级,但带来的直接后果是需要重新下载适配的 iOS Simulator 套件。

iOS_17.2_Simulator_Runtime.dmg 为例,这是一个 7.35G 的大文件,缺少了这个插件,无法在 Xcode 上进行模拟器和真机调试。而如果直接在 Xcode 引导下下载这个插件,很可能会频繁地出错且无法断点续传:

下载 iOS Simulator

这已经是我第二次遇到这个问题了,真是个很糟糕的体验。

解决办法

不要通过 Xcode 下载 iOS Simulator 套件,而是在 Safari 浏览器中打开 Apple 开发者网站。

https://developer.apple.com/download/all/?q=Xcode

找到对应的文件直接下载。

下载好之后,参考 Installing and managing Simulator runtimes 步骤安装。

关键命令:

sudo xcode-select -s /Applications/Xcode.app
xcodebuild -runFirstLaunch
xcrun simctl runtime add "~/Downloads/iOS_17.2_Simulator_Runtime.dmg"

运行 xcrun simctl runtime add 时如果出现类似如下错误:

D: 22A59611-EE3A-4386-9056-076B512C9941 iOS (17.2 - 21C62) (Unusable - Other Failure: Error Domain=SimDiskImageErrorDomain Code=5 "Duplicate of BFC13021-2F48-4F02-B05B-75313F47328D" UserInfo={NSLocalizedDescription=Duplicate of BFC13021-2F48-4F02-B05B-75313F47328D, unusableErrorDetail=})

可以打开 Xcode->Settings->Platforms,将已存在的重复条目删除后,重新执行命令。

Xcode Platforms

这个问题更像是一个 Bug,每次出现 SimDiskImageErrorDomain 报错时,都会在上图中增加一个标红的条目。

相关文章:

Using a Custom Toolchain in Xcode
Xcode 10/iOS 12适配
xcodebuild:code signature invalid
iOS:清除Xcode缓存
iOS crash log分析实践

发表留言

您的电子邮箱地址不会被公开,必填项已用*标注。发布的留言可能不会立即公开展示,请耐心等待审核通过。