Overview of the porting process
To make an existing Android app compatible with Fire OS and port it to the Amazon Appstore, use the following process.- Determine if your app uses any APIs, services, and features that are unsupported by Fire OS and migrate to a supported equivalent.
- Update your minimum API level as required for the Fire OS devices that you plan to support.
- Remove any unsupported features from your app.
- Recompile and test your app.
- Submit your app to the Amazon Appstore.
Step 1. Determine if APIs, services, and features are unsupported
If you have an existing Android app on Google Play, it might use Google Play services, which isn’t supported on Fire OS. If your app uses any APIs, services, or features that aren’t supported by Fire OS, update your code to use the equivalent Amazon-supported services and features. To help you with this process, the following section has Amazon-supported solutions for APIs, services, and features that your app might use.Solutions to use when porting from Google Play
If your Android app requires Google Play services or a feature available on Android phones, use the following table to find an alternative API, service, or feature that works with Fire OS.Firebase and alternatives
If you use Firebase libraries in your app, first determine whether the library is supported on Amazon Fire devices. Some Firebase libraries are compatible with Fire devices and you can continue to use them when porting your app. In cases where Firebase libraries aren’t compatible, you can use an alternative solution, or disable the library on Fire devices. Follow these steps to determine if a Firebase library works on Fire devices.- Determine if the library requires Google Play services. To do this, visit the Firebase documentation and review the “Google Play services not required” table. If the library doesn’t require Google Play Services, you can continue to use it on Fire devices.
-
Determine if the library is listed in the Google Play Service required or recommended section.
- If the library is listed as recommended, it might be partially compatible. Currently, the AdMob and Analytics libraries are listed as recommended. This means while most features should work, some automatic insights are only available on devices with Google Play services.
- If the library requires Google Play services, use an alternative library or disable the library on Fire devices.
| Unsupported Firebase feature | Description | Compatible alternative |
|---|---|---|
| App Check Play Integrity provider | Prevents unauthorized clients from accessing an app’s API resources. | Custom App Check Provider |
| App Check SafetyNet provider | Protects an app against security threats. This library is deprecated. | Custom App Check Provider |
| App Indexing | Indexes content to display in the Google Search App. This library is no longer recommended. | Android App Links or App Search depending on your requirements. |
| Cloud Messaging | Sends notification messages to a client app. | A3L Messaging |
| Dynamic Links | Determines where a link opens based on the environment where the user clicked the link. | Branch |
| Firebase Machine Learning (ML) | On-device machine learning for mobile apps. | AWS Machine Learning—use a solution that works for your needs. |
| Firebase ML Custom Model | Creates a custom ML model | AWS Machine Learning—use a solution that works for your needs. |
Step 2. Update your minimum API level
Amazon recommends setting a minimum API level of 10 to ensure compatibility with all Fire tablets. For information about the Android OS versions for the Fire tablets, see Fire Tablet Device Specifications. If your app uses methods introduced in:- API levels 11 through 15 - You must modify your implementation such that you do not call those methods on Kindle Fire (1st Gen).
- API level 16 or 17 - You must modify your implementation such that you do not call those methods on Kindle Fire (1st Gen) and Kindle Fire (2nd Gen) tablets.
- API level 18 or later - You must modify your implementation such that you do not call those methods on Kindle Fire (3rd Gen).
Step 3. Remove unsupported features
Before submitting your app to the Amazon Appstore, make sure to remove any unsupported features. The following features are unsupported by the Amazon Appstore:- Themes
- Wallpapers
- Screen savers
- Custom or third-party onscreen keyboards (use the default onscreen keyboard instead)
- Home screen widgets that manipulate the user interface
- disable_keyguard permissions
- Lock screen customizations

