Migrating An Existing App to the Amazon Appstore
Depending on your app's code, you may need to make some updates to your app's code base for your app to successfully run on Fire OS devices, such as Fire tablets. This page discusses the requirements that your app must meet and migration recommendations for submitting a Fire OS app to the Amazon Appstore.
- Overview of the Migration Process
- Supported APIs, Services, and Features
- Supported API Levels
- App Compliance
Overview of the Migration Process
Use the following process to guide you in migrating an existing Android app to be compatible with Fire OS for the Amazon Appstore:
- Migrate any APIs, services, and features to those supported by Fire OS, if necessary.
- If needed, 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 your app.
- Submit your app to the Amazon Appstore.
Supported APIs, Services, and Features
If your app uses any APIs, services, or features that are not supported by Fire OS, update your code to use the equivalent Amazon supported services and features.
The following table lists APIs, services, and features to modify in your Android app to enable it to work with Fire OS.
|API, Service, or Feature||Action||Migration Documentation|
|Google Play In-App Billing||Use the Amazon In-App Purchasing API.||Migrating from Google Play In-App Billing (IAB) v3.0 to Amazon In-App Purchasing (IAP) v2.0|
|Google Maps||Use the Amazon Maps API.||Migrating an App from Google Maps v2|
|Google Cloud Messaging||Use Amazon Device Messaging.||N/A|
|Google Game Play Services||Use Amazon GameCircle.||N/A|
|GPS geo-location on tablets without a mobile data plan||Use Wi-Fi geo-location or code your app to degrade gracefully.||N/A|
|Any phone feature||Code your app to degrade gracefully.||N/A|
|Device orientation||See Device Orientation.||N/A|
|Unsupported intents||See Android Intents Supported on Fire Tablets.||N/A|
|Unsupported screen sizes and layouts||Declare support for screen sizes in the AndroidManifest.xml.||N/A|
Supported API Levels
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).
For information about specifying API levels in your app, see Specify Minimum and Target API Levels in the Android training guide.
Before submitting your app to the Amazon Apps & Games Developer Portal, make sure that your app meets all of the requirements for the Amazon Appstore.
- Unsupported Features: Your app cannot include any of the following features, all of which are unsupported by the Amazon Appstore:
Note: If your app uses an API or hardware technology not supported on Fire OS, Amazon recommends that you remove or gracefully degrade any feature that requires that service. For example, your app might display a message stating that the feature is not currently available on this device.
- 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
- App Content: Your app must comply with Amazon's Content Guidelines. See Amazon Appstore Content Policy Requirements.
- App Testing: Test your app thoroughly before submitting it to the Amazon Appstore. To review test criteria and recommended test cases, see Test Criteria for Amazon Appstore Apps.