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

Use the following process to guide you in migrating an existing Android app to be compatible with Fire OS for the Amazon Appstore:

  1. Migrate any APIs, services, and features to those supported by Fire OS, if necessary.
  2. If needed, update your minimum API level as required for the Fire OS devices that you plan to support.
  3. Remove any unsupported features from your app.
  4. Recompile your app.
  5. 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 more information, see Check System Version at Runtime in the Android training guide Supporting Different Platform Versions.

For information about specifying API levels in your app, see Specify Minimum and Target API Levels in the Android training guide.

App Compliance

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:
    • 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
  • 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.