Getting 18.3.1 (22D8075) Simulator via xcodebuild

On my local machine I'm running Xcode 16.2.

I currently have:

  • iOS SDK 18.2 (22C146)
  • Simulator 18.3.1 (22D8075)

I'm setting up a CI machine to match my local setup, but I can't seem to get the 18.3.1 simulator on there.

I'm running:

xcodebuild -downloadPlatform iOS -exportPath ~/Downloads -buildVersion 16.2

The -buildVersion is 16.2 (I'm pretty sure to match the 16.2 of Xcode, as oppose to 18.2 for iOS) but this doesn't fetch the 18.3.1 simulator.

Is someone able to explain to me what's going on here?

I've not seen this mismatch before between Simulator and iOS but according to another post this seems like a valid setup, but I could be misinterpreting it.

Accepted Answer

It seems the docs I'm following aren't correct at:

https://developer.apple.com/documentation/xcode/downloading-and-installing-additional-xcode-components#Download-Xcode-components-from-the-command-line

To specify an Xcode version, add the -buildVersion option: xcodebuild -downloadPlatform iOS -exportPath ~/Downloads -buildVersion 16.0

But where Apple writes Xcode it seems this is the iOS version, so doing

xcodebuild -downloadPlatform iOS -exportPath ~/Downloads -buildVersion 18.3.1

For example gives me iOS 18.3.1

I've added a bug report FB16950119

@Adamc93 Thank you for filing your Feedback report. You are correct. The -buildVersion flag specifies an OS version. We are going to update the documentation.

Getting 18.3.1 (22D8075) Simulator via xcodebuild
 
 
Q