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
automationNamecapability toxcuitest. 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.
Navigate with the remote control
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
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!