Xcode will not download or install an iOS Simulator runtime
Could not download and install iOS Simulator runtimeShort answer
When the Platforms download in Xcode fails, skip the interface. Run xcodebuild -downloadPlatform iOS with the right Xcode selected, or export the runtime as a disk image and import it with xcodebuild -importPlatform. Run xcodebuild -runFirstLaunch first, so the system parts the runtime needs are installed.
Fix it fast
1Find out which cause you have
Download the runtime with the command-line tool. It shows progress and prints the real error if the download fails, which the Xcode window does not.
xcodebuild -downloadPlatform iOS2Match what you see, then jump to its fix
- 1
The download in Xcode Settings, Platforms ends with an error, or the run destination never finishes installingThe in-app download in Xcode keeps failingFix - 2
Import or download works with one Xcode but not another, or tools such as simctl are missingThe wrong Xcode is selected, or its first-launch components are missingFix - 3
A runtime is installed, but simulators for it do not appear when you run under RosettaThe runtime is the wrong architecture for how you run simulatorsFix
- 1
What does the error look like?
Could not download and install iOS Simulator runtime
Cause 1 of 3
The in-app download in Xcode keeps failing
1Check
Apple documents a command-line route that does the same download. While a runtime is still being installed, you can open the project but cannot build or run it for that platform.
xcodebuild -downloadPlatform iOS2Fix
Export the runtime to a folder as a disk image, then import that image. The import step is the documented way to install a downloaded runtime.
xcodebuild -downloadPlatform iOS -exportPath ~/Downloads
xcodebuild -importPlatform ~/Downloads/<the-downloaded-file>.dmg3Verify
Open Xcode Settings, Platforms: the iOS runtime is listed. The run destination menu shows simulators for it.
xcodebuild -runFirstLaunchConfirmed by developer.apple.com
Cause 2 of 3
The wrong Xcode is selected, or its first-launch components are missing
1Check
Apple's order is: select the Xcode you want, run first launch to install required system components (including simctl), then import the runtime.
xcode-select -p2Fix
Select the Xcode you build with, run first launch, then import or download again.
sudo xcode-select -s /Applications/Xcode.app
xcodebuild -runFirstLaunch3Verify
The download or import now completes with the selected Xcode.
xcodebuild -downloadPlatform iOSConfirmed by developer.apple.com
Cause 3 of 3
The runtime is the wrong architecture for how you run simulators
1Check
By default Xcode downloads a variant matching your Mac: an Apple silicon variant, or a universal variant for Intel Macs and when you use Rosetta run destinations.
xcodebuild -downloadPlatform iOS -architectureVariant universal2Fix
Ask for the universal variant explicitly when you need Rosetta destinations. It is larger on disk.
xcodebuild -downloadPlatform iOS -architectureVariant universal3Verify
Check the run destination list in Xcode for the simulators you need.
xcodebuild -runFirstLaunchConfirmed by developer.apple.com
How do I stop it coming back?
- Export the runtime with -exportPath and keep the disk image, so you have it for a later import.
- Select the Xcode you build with using xcode-select before installing components.
- Run xcodebuild -runFirstLaunch after every Xcode update.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.
Which stack is behind this page?
Related fixes
Mobile apps
xcrun cannot find simctl on a Mac with Xcode
xcrun: error: unable to find utility "simctl", not a developer tool or in PATH
simctl ships only inside Xcode, not in the Command Line Tools package.
2 causes, each with a fixMobile apps
flutter run on iOS says Unable to boot the Simulator
Unable to boot the Simulator.
Check the simulator list first.
3 causes, each with a fixMobile apps
Cannot change the App Privacy answers in App Store Connect
Publish Your App Privacy Responses?
Only the Account Holder, Admin and App Manager roles can answer the App Privacy questions.
2 causes, each with a fixMobile apps
App record creation fails because you lack permission
You cannot add a new app in App Store Connect as a Developer or limited user
Only the Account Holder, an Admin or an App Manager can create an app record, and Apple blocks it until the Account Holder has signed the latest agreement.
3 causes, each with a fixMobile apps
You cannot find the button to pull your app back from review
No 'remove this version from review' message appears on the version page
There is no button called Reject Binary.
3 causes, each with a fixMobile apps
Your Apple Account cannot sign in to App Store Connect
Sign-in to App Store Connect is refused for an account that should have access
App Store Connect does not open to every Apple Account.
3 causes, each with a fix