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 can be controlled only by SuitestDrive running on macOS operating system.

In order to use SuitestDrive, you need to pair it with your Suitest account first.

Installing Xcode

SuitestDrive relies on Xcode CLI tools to communicate with the Apple TV Simulator.

Issues when building with Xcode 12 or higher

Xcode versions higher than 11.7 have issues (e.g. [1], [2], [3]) related to official Apple libraries that are used by Suitest. This prevents Suitest from working properly. Please use an older Xcode version instead. You can download older versions from Apple developer website.

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

  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

    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

  • 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.