How to run appium java test cases on apple tv 4k

Feature
1

I have an apple tv 4k (tvos 17.6), I want to execute appium java test cases on apple tv. But unable to do it.
I have tried to connect apple tv with mac(where test scripts are present). Used below command

xcodebuild -project WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner_tvOS -destination ‘id=<device_udid>’ -derivedDataPath ./DerivedData test -allowProvisioningUpdates

After running this command, Got automation running message on the tv

IMG_20250224_173732
IMG_20250224_1737321322×1087 53.4 KB

When I have tried to connect appium inspector with the device.Got error as ‘Unknown device or simulator UDID’

IMG-20250228-WA0000
IMG-20250228-WA00001600×1029 174 KB

How to connect with appium inspector and execute appium java test cases on apple tv 4k real device

2

I’m not sure that Apple TV 4K is supported. I was looking at some documents to get a solution for you and found this:

Warning

Apple TV 4K is not supported. This is because appium-ios-device, which is used to support low-level communication with devices, only supports devices connected via USB.

That’s from the XCUITest current latest release which is 8.3.3.

3

But if we want to test for the Apple tv 4k device how to do it. I can see that headspin have developed some solution for this

IMG_20250303_115320
IMG_20250303_1153201080×1263 178 KB

4

Sorry I don’t use HeadSpin.