Skip to main content

Running On Device

To run your Hosanna app on a physical device, choose the launch target or native project for the platform you are validating. Roku, Apple TV, Android TV, Samsung TV, iOS, Android, and Web share the same application model, but each target has its own packaging and device workflow.

General Flow​

  1. Develop shared UI, state, AppConfig, fragments, and input behavior in Web.
  2. Select the platform launch target or open the native platform project.
  3. Deploy to an emulator or physical device.
  4. Validate startup, focus or touch input, navigation, networking, media playback, lifecycle resume, logging, and performance.

Platform Paths​

  • Roku: use the [ROKU] launch target, BrighterScript deployment, Roku developer mode, and source maps.
  • Apple TV and iOS: use the Apple native project, simulator/device runs, signing, provisioning, and Xcode release tooling.
  • Android TV and Android: use the Android project, Android Studio, emulator/device runs, signing, and Play Store release tooling.
  • Samsung TV: build the Samsung TV package from the web target, then validate on Samsung TV hardware.
  • Web: use the [WEB] launch target, Vite, browser DevTools, Hosanna DevTools, and the MCP debugger.

For target-specific details, see Platform Support and the platform page for your release target.