Home > Getting Started > Platforms > HTML5/Web Apps

Installing and Using the Amazon Web App Tester

Introduction

Amazon's Web App Tester lets you see how your HTML5 web app or mobile-optimized web site performs on a Fire tablet or Android device. When using the Web App Tester, second generation and newer Fire tablets can take advantage of a new, faster web runtime based on the open source Chromium project. You can use the Web App Tester to evaluate your app's performance before submitting your app to the Amazon Appstore.

Installing the Web App Tester

The Web App Tester is available for download from the Amazon Appstore. You can shop for the Web App Tester from within the Amazon app on your Fire tablet or Android device, or get it from the Amazon website. Once you have obtained the Web App Tester from the Amazon Appstore it should install itself on your Fire tablet or Android device. If it doesn't self-install, follow these directions to manually install the app:

  • Fire tablets: Access quick settings → Sync then go to Apps → Cloud to see your newly purchased app to download and install.
  • All other Android devices: Open the Amazon Appstore on your device, then go to Menu → My Apps → Cloud → Refresh to see your newly purchased app to download and install.

Loading Your Hosted App into the Web App Tester

There are two ways to load your hosted web app into the Web App Tester on the host device.

  1. Type in a URL that points to your app.
  2. Upload a JSON file containing one or more URLs.
Method Procedure
Type in URL Ensure you are on the Hosted Apps tab. Type your app's URL into the text box near the top of the page.
Upload JSON
  1. Using a text editor on your computer, create a file called amazon.testerurls.json.
  2. Enter the URLs of your web apps as shown in the following template:
    {
      "urls": [
        "http://m.imdb.com",
        "http://m.amazon.com",
        "https://read.amazon.com"
      ]
    }
  3. Connect the host device to your computer with a USB cable.
  4. On a Mac or Linux computer, consult the Kindle download support page for information on how to transfer files between your computer and an attached Android device. On Windows computers your host device should automatically show up.
  5. On your computer, navigate to the location where you saved amazon.testerurls.json and copy the file to the host device. When using a GUI file transfer tool on Mac and Windows computers, the amazon.testerurls.json file should go into the root directory. If using the Android Debug Bridge (ADB) to transfer files, put the amazon.testerurls.json into the /sdcard/ directory. When checking the contents of the host device's filesystem using ADB, the amazon.testerurls.json should reside in /sdcard/. The GUI tools' root directory is equivalent to the /sdcard/ directory.
  6. The URLs are displayed in a list below the URL text box.

Loading Your Packaged App into the Web App Tester

There are two ways to load your packaged web app into the Web App Tester on the host device.

  1. Type in a URL that points to a .zip file containing your app.
  2. Upload your .zip file to the /sdcard/amazonwebapps directory on the host device.
Method Procedure
Type in URL Ensure you are on the Packaged Apps tab. Type the URL of your .zip file into the text box near the top of the page.
Upload one or more .zip files
  1. Connect the host device to your computer with a USB cable.
  2. On a Mac or Linux computer, consult the Kindle download support page for information on how to transfer files between your computer and an attached Android device. On Windows computers your host device should automatically show up.
  3. On your computer, navigate to the location where you saved your .zip file and copy it to the host device. When using a GUI file transfer tool on Mac and Windows computers, the .zip file should go into the /amazonwebapps/ directory. If using the Android Debug Bridge (ADB) to transfer files, put the .zip into the /sdcard/amazonwebapps/ directory. When checking the contents of the host device's filesystem using ADB, the .zip should reside in /sdcard/amazonwebapps/. The GUI tools' root directory is equivalent to the /sdcard/ directory.
  4. On your host device, if the Web App Tester is open and your .zip file is not recognized, press the Sync List button to refresh the list.

Testing Your App

Once you have loaded your app into the Web App Tester, click the “Test App” button.

Clearing Stored Data and Cookies

The Clear All Browser Data menu near the top of the Web App Tester enables you to clear the data in your web view in the same manner as your app would using the web app cache API.

Next Steps

Set up Chrome DevTools to debug your web app. See Debugging your Web App.