• << Fire OS Developer Docs
• Get Started
  • Get Started with Fire Tablets
  • Set Up Your Development Environment for Fire Tablets
  • Create Your First Fire Tablet App
  • Connect to Fire Tablet through ADB
  • Get started with Amazon Stylus SDK
  • UX Specifications
  • User Agent Strings for Fire Tablets
  • Supported Android Intents
  • FAQs for Fire Tablets
• Fire OS for Fire Tablets
  • Fire OS 8 for Fire Tablets
  • Fire OS 7 for Fire Tablets
  • Fire OS 6 for Fire Tablets
• Android Apps
  • Screen Layout and Resolution
  • Device Orientation
  • Soft Key Bar
  • Button Size and Placement
  • Graphics Performance
  • Data Transfers and Mobile Networks
  • Launcher Icon Guidelines
  • App Installation Location
  • Advertising ID
  • Resources for International Locales
• Test your Android Apps
  • Run Your App on a Fire Tablet
  • Test Without an Amazon Device
  • Take Screenshots on Fire Tablets
• Web Apps
  • Get Started with Web Apps
  • Set up Development Environment
  • Best Practices for Developing Web Apps
  • Web App FAQs
  • Detect the Device Display Characteristics
  • Force the Device Orientation
  • Handle Device Orientation
  • Automatically Scale an Element to Fill the Screen
  • HTTP Caching
  • Protect Your Web App
  • Capture Media from Device Sensors
  • Use Geolocation Data
• Test Your Web Apps
  • Install and Use the Amazon Web App Tester
  • Debug Your Web App
  • Use the Debug APK to Test Your App
• HTML5 Hybrid Apps
  • HTML5 Hybrid Apps
  • Build and Test Your HTML5 Hybrid App
  • HTML5 Hybrid App FAQs
• React Native for Fire Tablet
  • Get Started with React Native (Fire Tablets)
  • Supported React Native Libraries (Fire Tablets)
• Accessibility
  • Assistive Technologies for Fire OS
  • Implement Accessibility in Fire OS
  • Accessibility Features
    • Implement Reading and Subscribing to AD/CC Settings

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

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
• Use ADB to Connect to your development computer
• Load Your Hosted App into the Web App Tester
• Create a Packaged App
• Load Your Packaged App into the Web App Tester
• Test Your App
• Clear Stored Data and Cookies
• Next Steps

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