Skip to main content

Android TV

Hosanna supports Android TV through the Android target. Shared TypeScript code defines the app experience, while the Android project handles native packaging, emulator/device execution, platform services, and Play Store delivery.

Development Flow​

  1. Iterate in Web for shared UI, focus, input, and layout behavior.
  2. Open the Android project in Android Studio.
  3. Run the Android TV emulator or a physical Android TV device.
  4. Validate DPAD focus, Back/Home behavior, text input, networking, playback, and app lifecycle.
  5. Package release builds through the Android toolchain.

Runtime Notes​

  • DPAD and remote events should enter the same input pipeline as other TV targets.
  • Shared views should use onInputEvent(event) and nextFocusMap(...) rather than platform-specific focus code.
  • Native Android services belong behind adapters or platform-specific modules.
  • Use AppConfig for shared style and fragment behavior, with platform overrides only when the target needs them.

Release Checklist​

  • Confirm package id, versioning, signing, and Play Store metadata.
  • Validate on emulator and at least one physical Android TV class device.
  • Test focus restoration, media controls, lifecycle resume, and low-memory behavior.
  • Check performance for collection-heavy screens and image loading.