Updating a Published App

If you update your app with new features, you can simply update your existing, published app in the Amazon Appstore, rather than creating a new one. Updating an existing app has several benefits:

  • Enabling you to retain the app's customer ratings and download statistics across versions.
  • Enabling your customers to receive app updates.

Update a Published App

  1. Sign in to the Developer Portal.
  2. From the Dashboard (the default homepage), scroll down to the Dashboard section to see a list of apps that you have created. Click the app you want to update.
  3. Near the top of the page, in the area below the name of your app, click Add Upcoming Version. A confirmation message appears — click OK to proceed.
  4. The portal creates a new set of metadata tabs for you. The General InformationAvailability & PricingDescriptionImages & Multimedia, and Content Rating tabs are marked with green checks mark to indicate that the required fields have been pre-filled with the information associated with the live version your app. If necessary, you may edit the information on those tabs.
  5. Fill out the fields of the Binary File(s) tab. The information needed is the same as if you were submitting a new app. See Step 7: Add App Files for more details. For information on submitting multiple APKs for the same application listing, see Multiple APKs for the Same Application Listing.

    When you are ready, click Save. Amazon will check all fields on the tab to confirm that the required fields are complete. If so, a green check mark will appear on the Binary File(s) tab to indicate that you can continue to the the next tab.

  6. Click the Release Notes tab. A set of release notes is required for each translation defined on the Description tab.
  7. Click Edit and add your release notes to the Release Notes text box. If you have more than one translation, click Save and Continue to go to the next language. Otherwise, click Save.

    When you click Save, Amazon checks all fields on the tab to confirm that the required fields are complete. If so, a green check mark will appear on the Release Notes tab. If all of the tabs have green check marks, you are ready to submit the updated version of your app.

    All tabs for your app should now have green check marks, and the Submit App button should be enabled. You can change the information on any tab until you submit your app.

  8. When you are ready, click Submit App.

Deleting a Submitted but Unpublished App

If you start to create a new version of your app, but decide not to publish the update, you can delete the unpublished version. Use the Delete Upcoming Version button, at the bottom of the page, to roll back to the currently published version of the app.

Modifying Device Support for Your App

The Amazon Appstore allows you to submit multiple APK files for a single app that target different devices. If you have multiple APKs targeting multiple devices, you only need to update the changed APKs when you update your app submission. Additionally, you can add or remove support for specific devices by adding or removing APKs from your app submission.

Adding Support for New Devices

To add support for a device that your app has not previously supported, create a new version of the app and do one of the following:

Removing Supported Devices

To remove support for a device, create a new version of your app and simply edit the APK that currently supports the device.

  1. On the Binary File(s) tab, in the Device Support section, click Edit device support.
  2. Deselect the device that you no longer want to support with this APK and click OK.
  3. Click Save, to save the updated APK.

Moving Device Support from One APK to Another

To move device support from one APK to another, follow these steps.

  1. Remove support for the device(s), as described in Removing Supported Devices.
  2. Update the APK that will now support the device(s) being moved, as described in Adding New APK Files to a Published App. Note that this updated APK must use a version code higher than the APK that previous supported the device(s) being moved.

Adding New APK Files to a Published App

To add additional APK files to a published app, follow these steps.

  1. Build your separate APKs following the guidelines in Build your APKs and Configure the Android Manifest
  2. Sign in to the Developer Portal, and click the name of the app you want to modify.
  3. Near the top of the page, in the area below the name of your app, click Add Upcoming Version, and click OK. You use the Upcoming Version feature both for updating exiting APKs and adding new APKs.
  4. Choose the Binary File(s) tab. The existing APKs are listed on this page.
  5. Click Upload Another Binary.
  6. Drag and drop the new APK file onto the Upload Binary box. You can also click Upload Binary to find and select the APK file to upload on your file system.
  7. Click Save and Add a Binary to add another APK, or Save to finish uploading.
  8. Repeat steps 6 and 7 to add as many APKs as needed.
  9. Choose the Release Notes tab. Each update you make to your original app requires release notes. For new device support, you can use a message such as "This update addresses compatibility for new devices."
  10. Click Save and then Submit App to submit the app with the new APKs.

Updating Existing APK files for a Published App

To update existing APK files for a published app, follow these steps.

  1. Build your separate APKs following the guidelines in Build your APKs and Configure the Android Manifest
  2. Sign in to the Amazon Apps & Games Developer Portal, and click the name of the app you want to modify.
  3. Near the top of the page, in the area below the name of your app, click Add Upcoming Version, and click OK. You use the Upcoming Version feature both for updating exiting APKs and adding new APKs.
  4. Choose the Binary File(s) tab. The existing APKs are listed on this page.
  5. Click the name of the APK you want to modify, and then click Edit.
  6. Delete the previous version of the APK file, by clicking the X icon and then clicking OK to confirm deletion.
  7. Drag and drop the updated APK file onto the Upload Binary box. You can also click Upload Binary to find and select the APK file to upload on your file system.
  8. Edit any of the original APK's information, if necessary, including the devices to which this APK applies.
  9. Click Save.
  10. Repeat steps 4 through 9 to modify as many APKs as needed.
  11. Choose the Release Notes tab. Each update you make to your original app requires release notes. For new device support, you can use a message such as "This update addresses compatibility for new devices."
  12. Click Save and then Submit App to submit the app with the updated APKs.

Transferring Your App to Another Vendor

If a situation arises (such as a company merger or spin-off) where you need to transfer one of your published apps to another developer account, you can do so with the help of Amazon support. Note that unless absolutely necessary, Amazon strongly discourages developers from transferring apps to different developer accounts.

To learn more about transferring your app, see How do I transfer an App from One Developer Account to another?.

How and When App Updates Happen for Customers (Fire TV)

For updates that do not have permission changes, Fire TV applies the update in the background. For apps that do have permission changes, the customer has to manually review the permission changes and apply the update. With apps that have permissions changes, the update process differs between Fire OS 6 and Fire OS 5 devices:

  • Updates for Fire OS 6 devices:

    On Fire OS 6 devices, permission approvals are applied at runtime (rather than at installation time), so customers don't have to manually approve the permission changes before the update is applied. Instead, the update gets applied in the background; when customers launch the app, they're prompted to approve the new permissions. In short, with Fire OS 6, any update can be installed, but access to the feature is deferred to runtime. (This assumes the app supports Marshmallow or later APIs, as this is when runtime permissions were introduced on Android.)

  • Updates for Fire OS 5 devices:

    Apps with API levels lower than Marshmallow (less than Level 23) require customers to manually approve the updates before the updates can be applied. For these updates, Fire TV sends an actionable heads-up notification every 24 hours letting customers know about pending approvals for updates. These notifications also stay in the Notification Center and take customers to a screen that shows all the pending updates.

    When customers launch an app that has a manual update pending, Fire TV shows a message that asks if customers want to update the app first before launching it. If customers decline, Fire TV does not prompt customers to update the app on subsequent launches for another seven days.

    If customers go to the app details page, an update button appears for apps that have a pending update.