The simulator app, available within Xcode, presents the iPhone or iPad user interface in a window on your Mac computer.

It is not possible to run Xcode on a Windows or Linux operating systems.

You interact with the Simulator by using the keyboard and the mouse to emulate taps, device rotation, and other user actions. It also allows you to automate your App without the need for a physical device.


  • You need a Mac computer and macOS operating system.

  • You need the TestProject Agent to be installed and running on your computer.

  • You need Xcode to be installed from Mac App Store.


With Xcode installed:

The TestProject Agent will detect all the simulators it comes with and display them in the connected simulators list in the TestProject application:

If the simulators are still not detected even when Xcode is correctly installed, open the terminal (using Launchpad), and make sure you have an active developer directory by running the command below:

xcode-select -p

If you do not have such a directory, you'll see the following message:

xcode-select: error: unable to get active developer directory, use `sudo xcode-select --switch path/to/` to set one (or see `man xcode-select`)

You can then proceed to use the following command, and then restart the agent to detect the simulators:

sudo xcode-select --switch path/to/

You can mirror any iOS simulator screen:

There is no need to have an Apple Developer Account in order to do this (on the contrary to IOS physical devices).

Simulators are launched headless, but you can also start it from Xcode and see it's window mirrored in TestProject application.

Common Issues:

Simulators not detected

If the simulators are still not detected, try running the following command and then restart the agent:

sudo xcode-select -s $(ls -td /Applications/Xcode* | head -1)/Contents/Developer

WDA Errors:

If you encounter errors when starting WDA on your simulators that are similar to this:

2021-07-18 02:22:22.461 ERROR 37497 qtp499764573-13 i.t.a.i.n Failed trying to start WDA on 2D3C1771-938B-43D7-A95C-5CCB834CE63E for unknown reason java.util.concurrent.ExecutionException: There was a problem connecting to the simulator with the udid of 2D3C1771-938B-43D7-A95C-5CCB834CE63E

Try to run the following command to shutdown all XCode simulators running on the machine:

sudo xcrun simctl shutdown all

Then try to run your test again TestProject agent should automatically start the simulator.

Did this answer your question?