Developer Console
Sign In
Sign In
Developer Console

Install and Use the Amazon Web App Tester (Fire TV)

You can use the Web App Tester to evaluate app performance before you submit the app to the Amazon Appstore. 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.

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.

Use ADB to Connect to your development computer

Before using Web App Tester, use ADB to connect your device to your development computer

See Connect ADB to Fire TV or Connect ADB to Fire Tablet.

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"
  ]
}
    • 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.

    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.

  3. 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. Click More Actions for additional options.

Next Steps

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

Last updated: Oct 29, 2020