App Tester prerequisites
Your development and testing environment must meet the following prerequisites to run test cases with App Tester:- Your development environment allows logging via ADB and logcat
- Your app implements Appstore SDK API method calls
- No SDK Tester on the device. SDK Tester is not compatible with App Tester or with the Appstore SDK.
Install App Tester
The App Tester is a free app that runs on Fire devices. Download App Tester from the Amazon Appstore:- Uninstall any versions of the SDK Tester tool that you used to test IAP v1.0.
- Download the App Tester.
- Uninstall any versions of the SDK Tester tool that you used to test IAP v1.0.
- On your device, start the Amazon Appstore app.
- Search for “Amazon App Tester”.
- Select the “Amazon App Tester” app. (Do not select the Web App Tester, which is a different app.)
- Tap through the prompts to download and install the app.
SYSTEM_ALERT_WINDOW permission, which allows it to draw overlays on top of other apps.
Create a JSON data file
App Tester responds to API calls using data stored in a JavaScript Object Notation (JSON) file. The file contains purchase data for the IAP items. You can automatically create the JSON file through the Developer Console.- In a web browser, go to your app’s page in the Developer Console.
- Add your IAP purchasable items to your app, if you have not already done so.
- Click the link to download your JSON Data File.
- Name the downloaded file “amazon.sdktester.json”.
-
Copy the file to the
/sdcard/folder in your device file system.$ adb push [_Your_JSON_File_Folder_]/amazon.sdktester.json /sdcard/amazon.sdktester.json
File format and example: IAP consumable and entitlement items
Consumable and Entitlement IAP Item Descriptions have the same format. The itemType property indicates whether the item is ENTITLED or CONSUMABLE. Every purchasable item is associated with a unique identifier called a SKU.File format and example: IAP subscription item
Subscription items are different from other types of items you can purchase. Every purchasable item is associated with an identifier called a SKU that identifies it as unique. When a subscription is purchased, there are two SKUs involved. One, the parent SKU, describes what the subscription is for (such as a magazine title). The other SKU is the terms SKU, which describes the terms (price, length) of the subscription. The terms SKU is what actually gets purchased by a customer. Since the terms SKU is the purchasable item, the JSON IAP item description is for that item. However, the description must also contain a reference to the parent SKU. Therefore, subscription item types include an additional property:subscriptionParent, as shown in the following example.
Verify your IAP items
You can review the contents of the JSON file. From the App Tester main menu, tap the IAP Items in JSON File option to display a human-readable list of the item data in the JSON file.Next steps
Familiarize yourself with the App Tester tool and the test options for IAP.- To learn how to use App Tester, see App Tester User Guide.
- For ideas on how to test your IAP functionality, see Design and Run Test Cases for IAP.

