Skip to main content
No Result Found
Get your setup working faster. Join our Discord for optimisation tips from elite testers. Join our DiscordJoin our Discord

What is BrowserStack App Automate with XCUITest for Apple TV?

Learn how App Automate runs your XCUITest test suites on real Apple TV devices and which features are available.

BrowserStack App Automate lets you run your existing XCUITest test suite for tvOS apps on real Apple TV devices housed in BrowserStack data centers. The workflow is the same as XCUITest on iOS: upload your app, upload your test suite, and start a build using the REST API.

XCUITest on Apple TV is available only on private devices dedicated to your group. To learn how to set up private devices for your group, see Custom Device Lab. To request access, contact support.

XCUITest framework and the Appium XCUITest driver

App Automate supports two ways to automate Apple TV apps:

  • XCUITest framework, covered in this section: You upload your own compiled XCUITest test suite, and App Automate runs it on an Apple TV device using the XCUITest REST API.
  • Appium with the XCUITest driver: You write Appium test scripts and set the automationName capability to xcuitest. To use this approach, see Smart TV testing with Appium.

Test on real Apple TV devices

Run your tests on Apple TV 4K devices running tvOS 26.x that are dedicated to your group. You can run on any of them or pin a build to one specific device.

Apple TV apps don’t use touch input. Your tests navigate the app through the focus engine using XCUIRemote, for example, XCUIRemote.shared.press(.select). These commands run inside your test on the device, so they work on BrowserStack without any additional setup.

Speed up test runs

Run tests on multiple Apple TV devices dedicated to your group in parallel to reduce your test execution time.

Debug failed tests

Access video recordings, device logs, network logs, and XCUITest logs for each test on the App Automate dashboard. You can also view per-test results using the REST API.

If your app plays DRM-protected content, that content appears as a black screen in the video recording. This is expected and doesn’t indicate a problem with your app or test.

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback!

Talk to an Expert
Download Copy Check Circle