Skip to content

docs: Update AppleTV guide#2761

Open
mykola-mokhnach wants to merge 3 commits intoappium:masterfrom
mykola-mokhnach:tv-docs
Open

docs: Update AppleTV guide#2761
mykola-mokhnach wants to merge 3 commits intoappium:masterfrom
mykola-mokhnach:tv-docs

Conversation

@mykola-mokhnach
Copy link
Contributor

No description provided.

appium
```

4. **Run your tvOS tests** using the Apple TV UDID:
Copy link
Member

@KazuCocoa KazuCocoa Mar 17, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Currently, these capabilities don't work since xcodebuild cannot find the given udid. The udid is not uuid xcodebuild can find. Also, port forwarding doesn't work to connect to the WDA running on the tvOS like attaching to a running WDA via http://127.0.0.1:8100/status.

So, what I was able to confirm with this remotexpc is:

  • webDriverAgentUrl: <url> or wdaBaseUrl: <url>
  • skipLogCapture: true

and the target TV had a running WDA process (I manually started from Xcode UI)

https://appium.github.io/appium-xcuitest-driver/latest/guides/attach-to-running-wda/

    {
      "platformName": "tvOS",
      "appium:automationName": "XCUITest",
      "appium:platformVersion": "18.0",
      "appium:udid": "<appletv-udid>",
      "appium:app": "/path/to/tvos/app.app",
      "appium:wdaBaseUrl": <url>,
      "appium:skipLogCapture": true
    }

I don't have a good app of my own, so I haven't tested it with app caps to try installing apps.

I'd prefer https://github.com/appium/appium-xcuitest-driver/blob/95fcf4ea1d1bf3cdc6d2199b6594a27e1d9575da/docs/guides/tvos.md#network-only-real-devices for most of users yet, since it works with xcodebuild while the functionality might be limited

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this all makes sense. We need to fix appletv udid detection first in remotexpc

Use the UDID that the pairing script (step 1) printed:

```bash
sudo appium driver run xcuitest tunnel-creation --udid <udid-from-pairing-script>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've now had a look into the script itself - what's the purpose of the --appletv-device-id argument (added in #2755) if this command doesn't use it?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm working on an update to the scripts doc, so I want to understand this behavior in order to better clarify the differences between the two options

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants