Run Your App on Vega Virtual Device or Fire TV Stick

Run your app on Fire TV Stick

Prerequisites

1. Install the Vega SDK.
2. Fire TV Stick 4K Select.

Step 1: Set up and register your Fire TV Stick

To set up and register your Fire TV Stick

1. Connect your Fire TV Stick:
   • To your development machine using USB cable.
   • To a display using the HDMI adapter.

   The next screen displays remote pairing.

2. Complete remote pairing:
   • Press Home button when prompted.
   • Follow on-screen instructions.
   • Wait for Fire TV logo to appear.
3. Configure settings:
   • Press Play/Pause on your remote.
   • Select your preferred language.
   • Connect to your network.
   • Enter your network credentials.

1. Complete device registration:
   • Sign in to your Amazon account either online or through QR code.
   • Follow on-screen instructions.
   • Wait for "Successfully registered" message.
2. Press OK when you see "Your Fire TV remote is now successfully set up."

Step 2: Configure Developer Mode

Developer Mode allows you to sideload apps and test development builds on your Fire TV device. But before your configure Developer Mode, make sure your Fire TV device meets the requirements and you understand the security implications. The process requires a reboot and temporarily interrupts running apps.

To configure Developer Mode

1. Access Settings using the Home button or the Home button shortcut.

   Using Home button

   • Press the Home button on your remote to go to the Home screen.
   • Navigate to the top menu bar.
   • Scroll right to find and select the Settings icon (gear symbol).

   Using Home button shortcut

   • Press and hold the Home button on your remote for 3 seconds.
   • Select Settings from the quick menu that appears.

2. Go to Settings > My Fire TV > About.

   

3. Select Fire TV Stick.
4. Press the center button on the remote control 7 times.

5. Press the Back button to return to My Fire TV.

   The Developer Options appears in the menu list.

6. Select Developer Options.

   The display indicates the Developer Mode status, which is Disabled by default.

7. Click Developer Mode to enable it.

   The device reboots automatically.

8. After device reboot, use the Back button on your remote and navigate to My Fire TV > Developer Options > Developer Mode.

   The Developer Mode status should show Enabled.

9. Check device recognition.

   Copy code Copied to clipboard.

    kepler device list
   

   Example output:

    Found the following device:
    [Serial Number] : [Device Number]
    Found the following devices:
    [Serial Number] : [Device Number]
    [Serial Number] : [Device Number]
   

10. Connect to the device.

    • If you have one device connected, use:

      Copy code Copied to clipboard.

      kepler device shell
      

    • If you have multiple devices connected, specify the device serial number:

      kepler device -d <Device Serial Number> shell
      

    Example output:

     (hostmachine)% kepler device -d <Device Serial Number> shell
    
     ##################################################
    
     ##### Welcome to Developer mode Shell #####
    
     ##################################################
    
     sh(com.amazon.dev.shell):/$
    

Step 3: Load your app on a Fire TV Stick

After you configure developer mode on your Fire TV stick, to load your app, open a new terminal to use the following commands.

One device connected to your computer

Replace <my-package.vpkg> with your package name.

kepler device install-app --packagePath <my-package.vpkg>

Multiple devices connected to your computer

Use the following command to specify the target device. Replace <Device Serial Number> with your device's serial number and <my-package.vpkg> with your package name.

kepler device -d <Device Serial Number> install-app --packagePath <my-package.vpkg>

Example output:

Installing/Updating '/tmp/keplerproject_armv7.vpkg' .. success

Step 4: Run your app on Fire TV Stick

After you have loaded your app on your Fire TV stick, to run your app, use the following commands.

One device connected to your computer

kepler device launch-app --appName <component-id>

Multiple devices connected to your computer Use the following command to specify the target device. Replace <Device Serial Number> with your device's serial number and <component-id> with your app's component ID.

kepler device -d <Device Serial Number> launch-app --appName <component-id>

Example output:

(hostmachine)% kepler device -d <Device Serial Number> launch-app --appName com.amazondeveloper.keplersampleapp
Launching app 'com.amazondeveloper.keplersampleapp' .. success