Adding an Apple TV Simulator to Suitest

Suitest supports Apple TV Simulators running tvOS version 11.2 or later. After setting up an Apple TV Simulator you will be able to run automated end-to-end tests on Apple TV apps.


Apple TV Simulators are operated by SuitestDrive. Before adding Apple TV Simulators to your Suitest account, you need to pair your SuitestDrive with your Suitest organization.

Installing Xcode

SuitestDrive relies on Xcode CLI tools to communicate with the Apple TV Simulator. Download the latest Xcode from the Apple developer website and install Xcode on your Mac.

Finding UDID

Once you have Xcode and SuitestDrive set up on your Mac, you can proceed with finding the UDID of your simulator. There are two ways to find the UDID:

  1. Open Xcode > Window > Devices and Simulators or press [SHIFT] + [CMD] + 2. Switch to the Simulators tab and select the tvOS simulator that you need to find the UDID for. The UDID is displayed as "Identifier".

    Identifier in Xcode
    Identifier in Xcode
  2. On your Xcode host, open the Terminal and input xcrun simctl list | grep TV to find the UDID of the simulator(s) that you would like to add.

    Finding the UDID of the Apple TV Simulators
    Finding the UDID of the Apple TV Simulators

    Do not add any devices with Unavailable description. Also, ignore the first entries, those are simulator types and not specific devices.

Add the Apple TV Simulator to Suitest

Open the Device wizard, select Add browser or emulator, choose your Control Unit from the drop-down, Apple TV Simulator from the platform list and then press Next.

Apple TV Simulator details
Apple TV Simulator details
  • UDID - The unique identifier of this Apple TV Simulator.

Fill in the field and press Next. Suitest will then verify that it can connect to your device. After verification the Apple TV Simulator will become available in your Suitest account.

Now that you have your Apple TV Simulator configured, it's time to instrument your app and start testing.

Something went wrong?

Please check the Apple TV troubleshooting section for guidance.