Install and Use the Amazon Web App Tester

Amazon’s Web App Tester lets you see how your HTML5 web app or mobile-optimized web site performs on a Fire TV device, Fire tablet or other 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.

Install the Web App Tester

The Web App Tester is available for download from the Amazon Appstore. You can install the Web App Tester from the Amazon Appstore on your device, or get it from the Amazon website.

If Web App Tester does not install, refer to Amazon Appstore installation help.

Load 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. Ensure you are on the Hosted Apps tab. Type your app’s URL into the text box near the top of the page.
  2. Upload a JSON file containing one or more URLs.
    • Using a text editor on your computer, create a file called amazon.testerurls.json
    • 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"
        ]
      }
      
    • Connect the host device to your computer with a USB cable.
    • 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.
    • 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 file into the /sdcard/ directory. When checking the contents of the host device filesystem using ADB, the amazon.testerurls.json file should reside in /sdcard/ . The GUI tools root directory is equivalent to the /sdcard/ directory.
    • The URLs are displayed in a list below the URL text box.

Create a Packaged App

A packaged HTML5 app project looks and works like a normal web project folder on a server. For example:

./project/index.html
./project/js/main.js
./project/js/libs/jquery.min.js
./project/css/main.css
./project/images/logo.png
./project/images/picture.jpg
...
etc

Create a zip file containing all of the files in the project folder.

Load 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. 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.
  2. Upload your .zip file to the /sdcard/amazonwebapps directory on the host device.
    • Connect the host device to your computer with a USB cable.
    • 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. On your computer, navigate to the location where you saved you .zip file and copy the file 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 filesystem using ADB, the .zip should reside in /sdcard/amazonwebapps/. The GUI tools root directory is equivalent to the /sdcard/ directory.
    • 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.

Test Your App

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

Clear Stored Data and Cookies

The Clear All Browser Data link (above the list of Apps) enables you to clear the data in your web view in the same manner as your app would using the [web app cache API][html5-web-apps/caching-and-security]. Click More Actions for additional options.

Next Steps

Set up Chrome DevTools to debug your web app. See [Debugging your Web App][html5-web-apps/debugging-webapp].