Running On Device

To run your Hosanna app on a physical device (such as Roku), follow these steps:

1. Enable Developer Mode: Make sure your device is in developer mode. See Roku Developer Mode Setup.

2. Use the Launch Target: In VSCode, select the [ROKU] launch target. This will:

   • Transpile your TypeScript code to BrightScript.
   • Bundle and deploy your app to the device using the BrighterScript plugin.
   • Enable breakpoint debugging in both .ts and .brs files.

3. Debugging:

   • Set breakpoints in your source files.
   • Use the BrighterScript VSCode extension for console output and debugging.
   • Enable the Hosanna extension's source sync for live updates.

4. Tips:

   • You can run the launch target without transpiling for faster debug cycles.
   • Network requests print curl statements for easy manual testing.
   • You can sideload manually by zipping the src folder and uploading via the Roku web interface.
   • Ensure your zip file is less than 4MB for Roku store compatibility.

For more details, see the guides on Native Development Roku and related configuration.