junit-appium-app-browserstack

This repository demonstrates how to run Appium tests in JUnit4 and Junit5 on BrowserStack App Automate.

Based on

These code samples are currently based on:

• Appium-Java-Client: 8.1.1
• Protocol: W3C

Setup

Requirements

1. Java 8+

   • If Java is not installed, follow these instructions:
     • For Windows, download latest java version from here and run the installer executable
     • For Mac and Linux, run java -version to see what java version is pre-installed. If you want a different version download from here

2. Maven

   • If Maven is not downloaded, download it from here
   • For installation, follow the instructions here

Install the dependencies

To install the dependencies for Android tests, run :

• For Junit4

  cd android/junit4-examples
  mvn clean

• For Junit5

  cd android/junit5-examples
  mvn clean

Or,

To install the dependencies for iOS tests, run :

• For Junit4

  cd ios/junit4-examples
  mvn clean

• For Junit5

  cd ios/junit5-examples
  mvn clean

Getting Started

Getting Started with Appium tests in Junit4 and Junit5 on BrowserStack couldn't be easier!

Run first test :

• Junit4

  • Update first.conf.json file inside the src/test/resources/com/browserstack/run_first_test of Android Junit4 examples or iOS Junit5 examples with your BrowserStack Username and Access Key
  • Run mvn test -P first

• Junit5

  • Update first.conf.json file inside the src/test/resources/com/browserstack/run_first_test of Android Junit5 examples or iOS Junit5 examples with your BrowserStack Username and Access Key
  • Run mvn test -P first

Speed up test execution with parallel testing :

• Junit4

  • Update parallel.conf.json file inside the src/test/resources/com/browserstack/run_parallel_test of Android Junit4 examples or iOS Junit5 examples with your BrowserStack Username and Access Key
  • Run mvn test -P parallel

• Junit5

  • Update parallel.conf.json file inside the src/test/resources/com/browserstack/run_parallel_test of Android Junit5 examples or iOS Junit5 examples with your BrowserStack Username and Access Key
  • Run mvn test -P parallel

Use Local testing for apps that access resources hosted in development or testing environments :

• Junit4

  • Update local.conf.json file inside the src/test/resources/com/browserstack/run_local_test of Android Junit4 examples or iOS Junit5 examples with your BrowserStack Username and Access Key
  • Run mvn test -P local

• Junit5

  • Update local.conf.json file inside the src/test/resources/com/browserstack/run_local_test of Android Junit5 examples or iOS Junit5 examples with your BrowserStack Username and Access Key
  • Run mvn test -P local

Note: If you are facing any issues, refer Getting Help section

Integration with other Java frameworks

For other Java frameworks samples, refer to following repositories :

• TestNG
• Java

Note: For other test frameworks supported by App-Automate refer our Developer documentation

Getting Help

If you are running into any issues or have any queries, please check Browserstack Support page or get in touch with us.