Amazon Developer

Console

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases

Console

as

Develop
Test
Publish
Monetize
Engage users
Device specifications
Resources

How Fire TV Development Differs from Android TV Development (Fire TV)

Because both Amazon Fire TV and Android TV use Android, you can push your same Android app out to both the Amazon Appstore and Google Play Store. Making your app available on both Amazon and Google stores can significantly increase the visibility and downloads of your app.

However, there are some differences with Fire TV that you need to account for in your code. Some of the differences are due to unique elements in the hardware or services. In some cases one service has features the other doesn't have, or they use different but equivalent services.

As you code for these differences, be aware that you can identify Fire TV devices and adjust your code to target different devices and behavior accordingly.

What's the Difference Between Amazon Fire TV and Android TV?

First, let's clarify what we mean by Android TV and Amazon Fire TV:

  • Android TV refers to the Android operating system that has been optimized for TV (starting at Lollipop and continuing through Nougat and beyond). Android Lollipop and the Leanback Support Library provide features that optimize Android for TV platforms. TV devices themselves can run Android TV as their native OS, or TVs can run Android through set-top boxes. You can learn more about Android TV on Wikipedia.
  • Amazon Fire TV refers to the Fire TV set-top box, stick, or smart TV that runs the Fire operating system (OS) on your TV. Fire OS versions include Fire OS 5, Fire OS 6, Fire OS 7, Fire OS 8, Fire OS 14, and Fire OS 16. Each version is based on an Android API level. For example, Fire OS 14 is based on API level 34 and incorporates updates from Android 12 through Android 14. Fire OS 16 is based on API level 36 and incorporates updates from Android 15 and Android 16. Fire OS uses the same Android operating system but also accommodates Amazon hardware and services. For more information, see Fire OS and Fire TV Device Specifications.

The important point is that both Android TV and Amazon Fire TV are Android-based, so the techniques you implement for your app share far more similarities than differences.

The following sections list the differences you need to account for in your code when planning for Fire TV.

Google Services

Any APIs that rely on Google-specific services, such as Google location services, aren't available on Amazon Fire TV. Although there is an Amazon Mobile Ads API, they are not yet supported on Fire TV.

LeanBack Support Library

Amazon Fire TV supports some but not all of Android's Leanback Support Library. For example, Fire TV uses TV-specific UI components from Leanback, Leanback widgets will work, and Fire TV will honor intents tagged for the LEANBACK_LAUNCHER. But Leanback's SearchFragment (described in the next section) is not supported.

For voice search, Android TV uses app controls that rely on Leanback APIs (for example, speech recognition with the SearchFragment). However, voice search on Amazon Fire TV does not use Leanback's SearchFragment. On Fire TV, voice search uses Amazon-specific system controls.

No matter where users are on Fire TV (whether on the Launcher or in an app), when users press the microphone button on a voice-enabled remote and say the TV show or Alexa actions they want, this action initiates a global search using the Alexa cloud service instead speech recognition APIs in the Leanback library.

Media requests through voice always return content from the Amazon Catalog. See Implementing Search in Fire TV for more details.

On Android TV, to integrate your content into global search, you can do so locally through your app using a search results ContentProvider.

With Amazon Fire TV, to make your content appear in global search results, you must integrate your media content with the Amazon Catalog. Submission to the Catalog is done through a cloud-based model (rather than locally within your app).

Audio Focus

If a user starts playing music from a music app prior to starting your app, Amazon Fire TV will continue to play music over your app. The Play/Pause buttons will control the music instead of the video in your app.

To receive the audio focus, your app must register a MediaButtonReceiver in your the manifest. The MediaButtonReceiver will transfer the audio focus to your app's media service when your app starts. See Audio Focus for more details and code samples.

Fast-forward, Rewind, and Menu Buttons

Both Android TV and Amazon Fire TV have 4-way directional pad (dpad), dpad_center/select, back, and play/pause buttons. However, Fire TV also offers rewind, fast-forward, and menu buttons that you can optionally use.

The Menu button on Fire TV invokes the Android context menu, which appears as a list of menu items centered on the screen. You can override the menu button to provide your own custom menu user interface, or for any other purpose.

If you only have one menu item, consider using the Menu button as a simple toggle — for example, to turn closed captions on or off. If you do this, consider providing an onscreen hint to expose this feature to your users.

In-app purchasing

Android TV often uses Google Play Billing for in-app purchases. For in-app purchases on Amazon Fire TV, you use Amazon's In-App Purchasing (IAP) API. For a detailed comparison of Google Play Billing and Amazon IAP, see Migrate from Google Play Billing to Appstore SDK.

Analytics

Android TV uses Firebase for Analytics. With Amazon Fire TV, you can use Amazon Mobile Analytics or another analytics package (Google Analytics, Flurry Analytics, Crashlytics, and so on).

Firebase

If you use Firebase SDKs in your app and want to continue using Firebase, you might need to implement some alternatives. Some Firebase SDKs depend on Google Play services, which are not available on Amazon devices.

If you're using Firebase SDKs, first determine if the Firebase SDK requires Google Play services. If the service or feature you use doesn't require Google Play services, you can continue to use it on Amazon devices. However, if the Firebase SDK requires Google Play services, you can choose to use an alternative product, or you can disable the Firebase feature on Amazon devices.

For more details on how to determine if the Firebase SDK you use is supported, and to learn about equivalents and alternatives, see Firebase and alternatives in "Port Existing Android App to Fire OS."

SDK Level

Each Fire OS version is based on a specific Android API level. Newer Fire TV devices run Fire OS 14 (API level 34) or Fire OS 16 (API level 36), and some older devices remain on earlier Fire OS versions. Before you target a Fire OS version, review the Android changes that affect your app:

To find which devices run which version of Fire OS, see Fire OS Versions and Fire TV Device Specifications.

Recommendations

Both Android TV and Amazon Fire TV let apps make recommendations on the home screen.

Emulators

To test your Amazon Fire TV app, you can use a Fire TV virtual device in Appstore Quality Central, or connect to a Fire OS 14 or Fire OS 16 smart TV through ADB. For details, see Live Device Interaction - Virtual Devices and Connect to Fire TV Through ADB.

Notifications API

You use the standard Android Notifications API for creating notifications for your Amazon Fire TV app. Fire TV provides the same toast notifications and persistence model as Android TV. However, in addition to toasts, Fire TV also provides Heads up notifications, which allow interactive buttons.

Additionally, instead of putting old notifications in a notification drawer, on Fire TV notifications are stored in a Notification Center. Learn more at Notifications for Amazon Fire TV.

Accessibility

Amazon Fire TV provides VoiceView to make your app accessible to the visually impaired. You can learn more about VoiceView and accessibility here:

Appstore

Android TV devices use the Google Play Store. In contrast, Amazon Fire TV uses the Amazon Appstore. Any links you have pointing to the Google Play store will need links to the Amazon Appstore.

Testing Your App

You can test your Android app's compatibility with Amazon by sideloading your app onto an Amazon Fire TV device. See Connecting to Fire TV Through ADB.

When you connect to a Fire TV device through ADB and run your app with Android Studio, a successful app will load and play. If you close your sideloaded app, you can find it by going to Settings > Applications > Manage Installed Applications.

Last updated: Oct 13, 2026

Follow us:
amazon_developer_logo

© 2010-2026, Amazon.com, Inc. or its affiliates. All Rights Reserved.

Terms

Amazon Developer Blog

Contact Us