Troubleshooting Android Manifest and Device Filtering
The Amazon Appstore uses your app manifest to determine an app’s compatibility with Fire devices. When you upload your APK in the Amazon Appstore, the APK Files tab highlights incompatibilities between your manifest and the capabilities of devices you are targeting. Use the troubleshooting information here to better understand any error messages related to device support.
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 these topics:
Also see the Troubleshooting section in the instructions for uploading your APK.
- Where Error Messages Appear
- android.hardware and android.software
- android.minSdkVersion and android.maxSdkVersion
- screenSize and screenDensity
Where Error Messages Appear
You upload your APK into the Appstore through the APK Files tab. If you click the View device support or Edit device support link in the "Device Support" section, you'll see whether your APK is supported by a particular device. If it isn't supported, you'll see an X next to the device, or it will be otherwise grayed out. You can move your mouse over the info tooltip and see the reason. Here's an example:
In this case, the error message is
android:minSdkVersion = '22'; device requires '15'. This means your APK requires at minimum API level 22, but the device only supports up to API level 15. Therefore, your APK can't be installed/supported on the device.
The following sections indicate common errors and their resolutions.
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" />
If your manifest includes permission for
ACCESS_FINE_LOCATION, this capability adds two implied features to the manifest:
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
<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
These messages indicate your manifest contains either a
<uses-permission> element for a capability not supported by the target device.
If you want your application to be available on a 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-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
- 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 getSystemAvailableFeatures in the Android 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"). See the Tablet Specifications and Fire TV Specifications for the Android and Amazon API levels for various Amazon Fire devices.
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
<compatible-screens>. To target the device, add support for the screen as described by "size" and "width", and update the manifest accordingly.
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 in [
<compatible-screens>](http://developer.android.com/guide/topics/manifest/supports-screens-element.html. To target the device, add support for the screen as described by "size" and "density", and update the manifest appropriately.
<compatible-screens>is not recommended. This element can dramatically reduce the number of devices available to your application i.e. Appstore will filter-out all devices with a screen configuration that you have not listed. You should use it only as a last resort, when the application absolutely does not work with specific screen size-density configurations.
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.
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 in
<supports-gl-texture>. 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.