Skip to content

tvOS XCUITest runner spike

  • Kind: decision
  • Date: 2026-10-31
  • Source: moved from how-it-works/plat/tvos/xcuitest-spike.md; #16062
  • Shaped: tvOS XCUITest spike

Context

The spike tested whether the XCUITest runner approach works on the tvOS simulator, using Xcode 26.6, tvOS 26.5 and an Apple TV 4K (3rd generation) simulator. The probe app was a SwiftUI app with a 3×3 button grid and a text field.

Options

Not recorded.

Decision

GO for the runner-dependent implementation: the spike demonstrated hierarchy, focus observation, remote input, text, sockets and screenshots. No simulator device-side questions remained. Physical Apple TV was out of scope; tvOS 27 and Duo-style runtimes were untried.

Consequences

Focus targeting is built from directional moves with a re-read after every press, because direct focus targeting is unavailable and the focus engine remembers the last item per column.