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 binary files (also called APKs) 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:

  • Add a new binary to support the device, as described in Adding New Binaries to a Published App
  • Edit device support on the Binary File(s) tab of an existing binary, to add support for the new device.

Removing Supported Devices

To remove support for a device, create a new version of your app and simply edit the binary 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 binary that will now support the device(s) being moved, as described in Updating Existing Binaries for a Published App. Note that this updated binary must use a version code higher than the binary 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 binary (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 binary, 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 binary 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 binary (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 binary’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?.