How to Configure Your App for Android VM Testing

Learn the different ways to make your Android app available for testing.

Setting Up Android Builds

Compile and export your application for testing.
Note: Make sure the Android .apk is compiled for x86, not ARM.

Uploading Your Application to Rainforest

After setting up your application for testing, there are 3 options for uploading the app to Rainforest for testing:

  • Uploading in-app
  • Uploading via the CLI
  • Uploading via a direct download link

If your app doesn’t load properly, check out Troubleshooting Mobile Builds.

Uploading Your Mobile App In-App

Rainforest allows mobile app upload in your Sites and Environments settings.

  1. Click the Settings icon (gear) in the navigation bar, then click Sites.
  2. Select the Apps tab, then click the New Mobile Site link.
  3. Give the app a unique name.
  4. Select the appropriate app type and add any URL. Then, click Done.
  5. Click the Edit icon (pencil) next to the app you added. Then, click the Upload button.
Uploading your mobile app in the UI.Uploading your mobile app in the UI.

Uploading your mobile app in the UI.

Uploading Your Mobile App via the CLI

To upload your mobile app via the CLI, install the Rainforest command-line interface. For more information, see How to Install the CLI.

  1. After setup, use the following CLI command to view your list of environments:
    rainforest environments --token YOUR_TOKEN
  2. Use this command to view your list of sites:
    rainforest sites --token YOUR_TOKEN
  3. Look up the relevant site ID and environment ID using the Sites and Environments page in Rainforest.
  4. Use this command to upload your app.
    rainforest mobile-upload --token YOUR_TOKEN --site-id 1234 --environment-id 5678 my_app.apk
    Note: Rainforest stores your app in a secure, nonpublic location.
  5. Return to the Settings page to view your newly uploaded app.
Rainforest stores your app in a secure location.Rainforest stores your app in a secure location.

Rainforest stores your app in a secure location.

Setting Up Your Android Application File as a Direct Download Link

Use a direct download link as an alternative to uploading your app via the CLI or in-app.

  1. Compile and export your application for testing.
  2. Host your app somewhere that supports direct downloads. The hosted file URL must be a direct download link.
  3. Go to Settings > Sites.
  4. Under Apps, click the New Mobile Site link and set the type to “Android VM.”
  5. Add the URL for your direct download.

Rainforest automatically downloads and installs your Android application on our VMs from this URL when you run a mobile test.

Keying in a direct download link.Keying in a direct download link.

Keying in a direct download link.


If you have any questions, reach out to us at [email protected] or via the chat bubble below.

Updated about a month ago



How to Configure Your App for Android VM Testing


Learn the different ways to make your Android app available for testing.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.