Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages
Flutter and app store releases

Xcode will not download or install an iOS Simulator runtime

ErrorCould not download and install iOS Simulator runtime

Short 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.

  • Applies to Xcode 26, macOS 26
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Fix it fast

  1. 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 iOS
  2. 2Match what you see, then jump to its fix

    1. 1The download in Xcode Settings, Platforms ends with an error, or the run destination never finishes installingThe in-app download in Xcode keeps failingFix
    2. 2Import 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. 3A 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

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 iOS

2Fix

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>.dmg

3Verify

Open Xcode Settings, Platforms: the iOS runtime is listed. The run destination menu shows simulators for it.

xcodebuild -runFirstLaunch

Confirmed by developer.apple.com

Did this fix it?

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 -p

2Fix

Select the Xcode you build with, run first launch, then import or download again.

sudo xcode-select -s /Applications/Xcode.app
xcodebuild -runFirstLaunch

3Verify

The download or import now completes with the selected Xcode.

xcodebuild -downloadPlatform iOS

Confirmed by developer.apple.com

Did this fix it?

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 universal

2Fix

Ask for the universal variant explicitly when you need Rosetta destinations. It is larger on disk.

xcodebuild -downloadPlatform iOS -architectureVariant universal

3Verify

Check the run destination list in Xcode for the simulators you need.

xcodebuild -runFirstLaunch

Confirmed by developer.apple.com

Did this fix it?

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 fix

Mobile 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 fix

Next step

Want this handled for good?

I look after servers, apps and releases end to end. Tell me what keeps breaking.