How do I add different simulators to my iOS builds?

The Xcode images are preinstalled with recent versions of the simulator runtime. A list of the simulator runtimes, along with simulator devices, can be found in the image manifest.

Adding a simulator runtime

If a different simulator runtime is required for your tests, you can use the xcode-install gem to download these within your job. For example:

-run: gem install xcode-install
-run: xcversion simulators --install="13.2" --no-progress

Please note that downloading additional simulator runtimes may increase build times.

Creating a new simulator

If you need to create a specific simulator combination that is not provided by default, you can create these with the xcrun simctl create command. An example may look like this:

-run: xcrun simctl create 'iPhone 11 (13.2)' com.apple.CoreSimulator.SimDeviceType.iPhone-11 com.apple.CoreSimulator.SimRuntime.iOS-13-2