Build and Test Your HTML5 Hybrid App

Amazon WebView API (AWV) is a Chromium-derived web runtime exclusive to Fire OS. AWV is a transparent replacement for the standard Android WebView. AWV makes it possible to create better performing and more powerful hybrid web apps.


To build and test a HTML5 hybrid app that uses the Amazon WebView API, you must set up your development environment for Android development. This includes:

  • The Android SDK and any of its requirements for your development system. Note: To support Amazon WebView you must install the API level 17 SDK package.
  • The Java Development Kit.

It is also useful to have an integrated development environment installed, such as Android Studio.

Test Your App on an Amazon Device

Install and Run Your App

See Use ADB to Install Your App on a Fire Device.

Guidelines for Testing Your App

Make sure that you include the following in your test plans:

  • Test whether your web pages appear when you run your app.
  • Test whether you set the needed permissions in your AndroidManifest.xml.
  • Test all of your web-related functionality.
  • Where the Android WebView and the Amazon WebView functionality differ, verify that your app works as you intended, particularly if you migrated the app from Android WebView.
  • Verify that your app gracefully adjusts to devices that do not support Amazon WebView. For example, test your app on a 1st or 2nd generation Kindle Fire device to ensure that the app runs successfully with all functionality gracefully degraded.

Enable remote debugging

If you are testing your hybrid app with a device running Android 4.4 or higher, you can remotely debug your web pages in WebView with Chrome Developer Tools. See the Getting Started instructions.