Getting Started with Live App Testing

This page provides an introduction on how to use Amazon’s Live App Testing service.

Step by Step Guide for App Developers

  1. Go to https://developer.amazon.com/myapps.html and click My Apps. Sign into your developer account. If you do not already have one yet, you can create one now.

    My Apps
    My Apps button
  2. Select an existing app or click Add a New App.  If you click Add a New App, go to step 3, otherwise, skip to step 4.

    Select An Existing App
    Select An Existing App
    Add a New App
    Add a New App
  3. After clicking Add a New App, select Android.  Click Next and then fill out the New App Submission information.

    Select Android
    Select Android
    New App Submission
    New App Submission
  4. Click Live App Testing to set up a test for this app.  Once on the following page, click Start your first test run to begin the process of setting up your first test.

    Start your first test run
    Start your first test run
  5. Fill out all of the required tabs.  In this step, you add the metadata and the APK that you want to test.
    Add metadata
    Add metadata
  6. After you fill out each tab, you can either submit your app (without assigning testers) or go to the dashboard and add testers.

    If you are not ready to add testers at this time, you can click Submit to submit the app for publishing.  This process can take up to a few hours.

    If you would like to add testers before submitting your app, click Go to Dashboard to add testers:

    1. On the dashboard, click Add Testers to add testers to the test.

      Add Testers
      Add Testers
    2. On the testers page, click Add Testers.

      Add Testers
      Add Testers
    3. Either upload a list of tester email addresses, or add the testers individually.  You can add yourself as a tester so that you get the invitation email as notification that the binary is available to download and test.

      Upload email list or add individual testers
      Upload email list or add individual testers
    4. After you add the testers, click Save.

      Save
      Save
  7. After adding testers, select the gear icon, and then click Submit.

    Submit
    Submit

You have completed the process.  Testers will receive an email to join your test once the app is live. The email will contain a link to your app’s test page with instructions on how to download and install your app on Fire and Android devices.

Managing Your Test

Once your app is running, you can either end your test, or promote your test to an upcoming version.  By promoting your app to an upcoming version, you can make finishing touches such as uploading final screenshots or metadata before going live.

Tests that have ended appear on the Live App Testing dashboard under the Past Tests section.

Past Tests
Past Tests

On the Live App Testing dashboard, you can also easily see the crashes that have occurred during the test.

Testing New Versions of Published Apps

You can test new versions of published apps, by selecting your app in the Amazon Developer Console and clicking Live App Testing, at the top of the screen. The first time you create a test version of a published app, APKs and metadata are copied from the live version to create the test version.

APKs and metadata can then be modified for the test, if necessary. Subsequent test versions are created by copying the APKs and metadata from the most recent test version of the app.

Steps for App Testers

When your app testers receive their invitation to participate in Live App Testing, they will need to perform the following steps:

  1. In your email invitation, click the link for the marketplace that you will be testing:

    LAT invitation email
    LAT invitation email

    The link will open the retail page for the app in the specified marketplace.

  2. On the app retail page, from the Deliver To: drop-down menu, select the device where you want to install the app.

    App retail page
    App retail page

    If a particular device is not available in the tester’s current marketplace, that device will not appear in the drop-down menu. If none of the devices that your app targets are available in a given marketplace, the drop-down menu will be replaced with a Continue button on the app’s retail page:

    Device not available
    Device not available
  3. Install the app to the specified device. You can test on as many devices as you have associated with your Amazon account that the app targets.

Submitting Your App Directly from Live App Testing

Once you are satisfied with your app testing results, you can directly submit your app to be published to the Amazon Appstore. To directly submit your app:

  1. Navigate to your Live App Testing Dashboard page.
  2. From the Actions drop-down menu, select Promote to Upcoming.

You will be required to fill out any missing metadata for your app, but you will not need to re-upload your APK. Amazon will email you when your app is live on the Amazon Appstore.