android-app

Testing an Android App

If you have an Android native application, you can test it with Appium on a Simulator in Sauce Labs Virtual Device Cloud, or on a Real Device in the Sauce Labs Real Device Cloud.

Setup Instructions and Contribution Information can be found on the Main README.

Executing Examples

The Android app being tested is found in the My Demo App Android Repository

1. After cloning this repo from instructions, change to this subdirectory:

   $ cd appium/android-app
   

2. Run the following command to update any package dependencies:

   $ mvn dependency:resolve
   

3. Then run the following command to compile your test code:

   $ mvn test-compile
   

4. Finally, run the following test to see if you've properly configured the test environment:

   $ mvn clean test
   

   See passing tests on GitHub Actions

Configurations

This code allows toggling what cloud the tests will target. The capabilities for these configurations can be copied from the Platform Configurator, and can be viewed in the Test Configurations file.

Virtual Device Cloud (default)

Tests will execute on an emulator:

$ mvn clean test -Dsauce.cloud=vdc

Real Device Cloud

Tests will execute on a real device:

$ mvn clean test -Dsauce.cloud=rdc

Disclaimer

The code in these scripts is provided on an "AS-IS" basis without warranty of any kind, either express or implied, including without limitation any implied warranties of condition, uninterrupted use, merchantability, fitness for a particular purpose, or non-infringement. These scripts are provided for educational and demonstration purposes only and should not be used in production. Issues regarding these scripts should be submitted through GitHub. These scripts are maintained by the Technical Services team at Sauce Labs.

Some examples in this repository, such as appium-example, parallel-testing, and headless, may require a different account tier beyond free trial. Please contact the Sauce Labs Sales Team for support and information.