Skip to main content

Building For Apple TV

Use the Apple TV target when you are ready to validate the shared Hosanna app on tvOS hardware or simulator. Most UI, AppConfig, fragments, focus, and input behavior should be developed in Web first, then finished on the Apple TV target.

Prerequisites​

  • macOS with Xcode installed.
  • Access to the licensed Hosanna framework sources and tooling for the project.
  • Apple signing credentials, bundle identifiers, and provisioning profiles for device or release builds.
  • The project dependencies installed with npm install.

Build And Run​

  1. Generate Hosanna structs and project metadata if your project does not do this automatically: 
    npm run generate
  2. Open the Apple native project from the project platform folder.
  3. Select an Apple TV simulator or physical Apple TV device.
  4. Build and run from Xcode or the configured launch target.

Debugging​

  • Use Web for fast iteration and the MCP debugger for shared state, focus, and input inspection.
  • Use Xcode for native logs, signing issues, lifecycle events, and device-specific failures.
  • Validate Siri Remote directional input, select/back behavior, safe areas, app resume, networking, and playback on hardware.

See Apple TV for platform-specific runtime notes.