Installing and Running Your App


To test and debug your Amazon Fire TV app before submitting it to the Amazon Appstore, use Eclipse or the Android Debug Bridge (ADB) to install it on the Fire TV device. This is sometimes referred to as "sideloading" an app. This document describes how to install, run, and uninstall your app on the device, with Eclipse and ADB on the command line.

You must have already used ADB to connect your development computer to Fire TV for the Eclipse- and ADB-specific instructions to work. See Connecting ADB.

Note: Certain development tools and resources referenced on this page are provided by third parties, not by Amazon. Any links to these tools and resources will take you to third-party sites.

Installing and Running Your App (Eclipse)

Use the Eclipse IDE to both install and run your apps on Amazon Fire TV. To install and run your app with Eclipse, use the following steps:

  1. In the Eclipse package explorer, right-click your project.
  2. Click Run as, and then click Run Configurations.
  3. In the left navigation column, right-click Android Application.
  4. Click New to create a configuration.
  5. In the Name box, type a name for the new configuration.
  6. On the Android tab, next to the Project box, click Browse.
  7. Select the project for your app, and then click OK.
  8. On the Target tab, click Always prompt to pick device. This setting enables you to choose Amazon Fire TV each time you run your project.
  9. Click Run.
  10. Select the device where you want to install and run the app, and then click OK.

The run configuration you define is saved. The next time you run your project from Eclipse, after clicking Run as (Step 2), you can click Android Application to use that saved run configuration.

Installing Your App (Command Line)

To install your app onto Amazon Fire TV from the command line, use this command, where <path-to-apk-file> is the file system path to your app's APK:

adb install <path-to-apk-file>

If the installation was sucessful, ADB responds with the message similar to this one:
764 KB/s (217246 bytes in 0.277s)
pkg: /data/local/tmp/HelloWorld.apk

To re-install an app that already exists on the device, you can use the -r option to reinstall the app:

adb install -r <path-to-apk-file>

Note that reinstalling an app does not replace any existing additional user data or cache. If you want to clear this data, uninstall the old app before installing a new version, or clear the data by hand in System > Applications.

Running Your App (Device)

Sideloaded apps do not appear in the launcher. To run your app, use the following steps:

  1. From the main screen, select Settings > Applications.
  2. Select your app.
  3. Select Launch application.

Running Your App (Command Line)

To send a launch intent to your app on the Amazon Fire TV device, use this command, where is the package name of your app, and MainActivity is the name of your app's primary activity.

adb shell am start -n

ADB responds with a message similar to this, and your app begins running:
Starting: Intent { }

Uninstalling Your App (Device)

To uninstall your app from Amazon Fire TV on the device itself, use the following steps:

  1. From the main screen, select Settings > Applications.
  2. Select your app.
  3. Select Uninstall > Uninstall.

Uninstalling Your App (Command Line)

To uninstall your app from the command line, you need the package name for your APK. Use this command to uninstall your app, where is the package for your app.

adb uninstall

If you are unsure of your app's package name, use this command to see a list of all the installed APKs and their package names:

adb shell pm list packages -f

Unavailable During Maintenance