Instructions for RVS Sandbox Environment
Use the RVS Sandbox along with the App Tester testing tool to verify your receipts in a test environment before you publish your app to the Amazon Appstore. The RVS Sandbox is included as a .war file in the Amazon Android SDK zip file. From the Apps & Games Services SDKs page, click the Android link to download the SDK file.
You must install the Amazon App Tester tool on an Android mobile device before you can use the RVS Sandbox.
To set up the RVS Sandbox:
- Install and start the Apache Tomcat server:
- From the Apache Tomcat website, download and install the Apache Tomcat server (version 6 or later).
Configure Tomcat to use your credentials. In the /apache-tomcat-< version >/conf/tomcat-users.xml file, add the following elements:
<tomcat-users> <role rolename="manager-gui"/> <user username="MyUserName" password="MyPassword" roles="manager-gui"/> </tomcat-users>
If you have not already done so, change the permissions on the /apache-tomcat-< version >/bin/startup.sh to make the file executable:
$ chmod +x /apache-tomcat-< **_version_** >/bin/startup.sh
To start the Tomcat server, run the /apache-tomcat-< version >/bin/startup.sh file.
$ /apache-tomcat-< **_version_** >/bin/startup.sh
Verify that the Tomcat server is running by opening a web browser window and going to:
If the Tomcat server is running, you will see the Apache Tomcat/< version > homepage. Now you can deploy the RVS Sandbox.
- Deploy the RVS Sandbox:
- Unzip the Amazon Android SDK zip file.
- In the Amazon Android SDK folder, navigate to
- Locate the
RVSSandbox.warfile and note its file path.
- From the Tomcat homepage in your browser, select Manager App, and scroll to the Deploy section.
- From the Deploy section, navigate to WAR file to deploy > WAR file to upload > Browse > From Apps-SDK, choose the
- Choose Deploy to view the RVSSandbox in the list of applications. Be sure that the Running column has a value of
From the list of applications choose RVSSandbox, or in the browser visit
The following confirmation message indicates that the RVS Sandbox is running:
Receipt Verification Service Sandbox is up!