Page tree
Skip to end of metadata
Go to start of metadata

In addition to working with physical devices, you can also work on simulators to create and run tests.

Minimum requirements

Mac machine with XCode 8+ is required.

Preliminary setup

Before working with simulators in the studio, the desired simulators must be installed through XCode.

Add new simulator

  1. Open XCode
  2. In the Window menu select Devices (1)
    Currently installed simulators are listed in the left pane
  3. Click on the + sign at the bottom of the list and then Add Simulator (2)

  4. In the new dialog (3), choose a name for your simulator, it's iOS version and click on Create 

XCode dialog

Add new iOS version

  1. From the 'Create a new simulator' dialog, click on the OS Version box
  2. Click the arrow next to the versions you wish to download

XCode dialog



Supported iOS versions

Currently, only iOS 10+ is supported by the studio. If there are simulators with lower versions installed, they will not appear in the Studio.



Add simulator in the Studio

  1. Open the Add Device dialog and select iOS device
  2. Select the checkbox 'Show Simulators'
  3. The supported simulators will be listed in the Simulator box (marked in the following image)
  4. Select a simulator from the list
  5. Click OK


The simulator will be booted immediately. The first time a simulator is booted, boot might take up to 10 minutes, because it needs to be set up. Next boots should take about 1 minute, depending on your Mac's specifications.

Booting simulator


Current simulator limitations

  1. Only a single simulator can be on 'Device manager' at a time. The Add Device dialog won't allow adding more simulators if there already is a simulator added.
  2. To use a different simulator, the current simulator must be deleted first from the Device Manager.

Delete simulator

Deleting a simulator from the Device Manager will shut it down. A progress bar will be displayed while the shutdown is in progress.

Simulator applications

Building applications

iOS simulators running on your Mac run on a different architecture than physical devices. This means 'regular' application files won't work on simulators.

To build your applications for simulators:

  1. Open the application project in XCode
  2. Open the project settings (1), by clicking the root file in the Project Files left pane 
  3. Select a build Target (2)
  4. Click on Build Settings (1)
  5. Under Architectures, select No in Build Active Architectures Only (2)
  6.  Select a simulator from the devices list (3)



  7. Build your application, from the Product menu click Build (1)
  8. When the build ends successfully, the output file (.app) can be taken from the Products folder (2)
  9. Right-click the application under Products and select Show in Finder
     This .app file can be used for installation on simulators in the studio

    Build and output application


Import  application to studio

Click 'import' from the application manager and select the .app application file.

Application testing limitations

Currently, instrumentation is not supported.

Web testing on Safari is not yet supported.

  • No labels