Home > Support > Submitting Your Apps

Troubleshooting Android Manifest and Device Targeting

Introduction

Introduction

The Amazon Appstore uses industry-standard AndroidManifest.xml files to determine an app’s compatibility with Fire devices. The Binary Files tab highlights incompatibilities between your manifest and the capabilities of devices you are targeting.

If you are planning to update your APK, you must fix compatibility issues in your manifest in order to maintain your current device support. If you do not fix compatibility issues, your app will not be available on devices that have been flagged.

This article describes common incompatibility messages and potential resolutions.  For more information about Appstore’s manifest filtering, see Supported Manifest Filters and Targeting Amazon Devices with Your Android Manifest.

android.hardware.touchscreen

Touchscreen support is assumed for all Android APKs unless explicitly defined otherwise. This message indicates that your manifest will only target devices with a touchscreen, and is therefore incompatible with non-touchscreen devices (like Fire TV). If you want your application to be available to devices that do not have a touchscreen, you must explicitly declare that a touchscreen is not required by adding the following element to your manifest:

<uses-feature android:name="android.hardware.touchscreen" android:required="false" />

android.hardware.location

If your manifest includes permission for FINE LOCATION, this capability adds two implied features to the manifest:

android.hardware.location
android.hardware.location.gps

Because the implied features are required, the APK is deemed not compatible with any device that does not provide those features. To allow these devices, you need to explicitly include the implied features in your manifest, with the android:required attribute set to false:

<uses-feature android:name="android.hardware.location" android:required="false" />
<uses-feature android:name="android.hardware.location.gps" android:required="false" />

Refer to Implied Features for additional information.

android.hardware and android.software

android.hardware._feature
android.software._feature

These messages indicate your manifest contains either a <uses-feature> or <uses-permission> element for a capability not supported by the target device.  

If you want your application to be available on a target device that has this warning, do one of the following:  

  • If your APK does not actually use the feature in question, remove the offending <uses-feature> or <uses-permission> element from the manifest.
  • If your APK uses the feature in question, but does not strictly require it (i.e. your app tests for the capability and disables related functions if not present), add or adjust the <uses-feature> element to include the attribute android:required="false".
  • If your app strictly requires the feature in question, to safely target the device, you should make code changes so the app gracefully disables functionality on devices without the feature. After testing your changes, modify the manifest to include android:required="false" in the appropriate <uses-feature> element.  For more on detecting capabilities, refer to the Android getSystemAvailableFeatures API documentation.

android.minSdkVersion and android.maxSdkVersion

android.minSdkVersion = "X"; device requires "Y"
android.maxSdkVersion = "X"; device requires "Y"

These messages indicate that the range of Android API levels specified in the <uses-sdk> element exclude the Android API level currently supported by the target device (“Y”).  If you intended to target the device, adjust the Android API range to include level (“Y”). The [Manifest Filter Reference][manifest-filter] shows both the Android and Amazon API level for each Fire device on the market.

amzn.minSdkVersion and amzn.maxSdkVersion

amzn.minSdkVersion = "X"; device requires "Y"
amzn.maxSdkVersion = "X"; device requires "Y"

These messages indicate that the range of Amazon API levels specified in the <uses-amzn-sdk> element exclude the Amazon API level currently supported by the target device (“Y”).  If you intended to target the Fire device, adjust the Amazon API range to include level (“Y”). The [Manifest Filter Reference][manifest-filter] shows both the Android and Amazon API level for each Fire device on the market.

amzn.minSdkVersion

When this message is presented by itself (with no level information), it indicates that your APK manifest includes <uses-amzn-sdk>, and therefore requires support from an Amazon SDK which is not present on the target device. This message should only be displayed for non-Amazon devices.</div>

supports-screens

supports-screens = "X"; device requires "size" (and/or "width")

This message indicates there is no overlap between the screen sizes and/or smallest width defined in the <supported-screens> element and those supported by the device. Appstore applies device filters as described in the Android spec which can be found on this page. To target the device, add support for the screen as described by “size” and “width”, and update the manifest accordingly.</div>

screenSize and screenDensity

No supported screenSize and screenDensity pair in manifest; device requires "size" and "density"

This message indicates there is no overlap between the <screen> elements specified in the <compatible-screens> element and those supported by the device. Appstore applies device filters as described in the Android spec which can be found on this page. To target the device, add support for the screen as described by “size” and “density”, and update the manifest appropriately.

android.glEsVersion

android.glEsVersion = "X"; device requires "Y"

This messages indicates your APK specifies an OpenGL ES version that is not supported by the target device. To target this device, consult its reference documentation for the proper OpenGL ES version, and update the manifest appropriately.</div>

supports-gl-texture

No supported supports-gl-texture formats in manifest

This message indicates there is no overlap between the OpenGL texture compression formats specified in the manifest and those supported by the target device. Details for supported texture compression formats can be found on this page. To target the device, add support for a compatible texture format, and update the manifest appropriately. Also, check the capitalization and spelling of the OpenGL texture format in the manifest vs. the device specification.