Run your first test

BrowserStack App Automate enables you to test native and hybrid mobile applications using the Appium automation framework. Its easy to run your Appium tests written using JUnit framework on real Android and iOS devices on BrowserStack. In this guide, you will learn how to :

1. Setup your environment
2. Upload your app
3. Configure and run your first test
4. View test execution results

1. Setup your environment

• You will need a BrowserStack username and access_key. If you haven’t created an account yet, sign up for a free plan or purchase a paid plan. After signup, you can obtain your access credentials here
• Ensure you have Java 8+ installed on your system. You can download updated Java versions from java.com
• Ensure you have the Maven installed on your system. To install Maven, follow steps outlined in the installation guide
• You will need access to your Android app (.apk or .aab file) or iOS app (.ipa file)

2. Upload your app

Upload your Android app (.apk or .aab file) or iOS app (.ipa file) to BrowserStack servers using our REST API. Here is an example cURL request to upload app on App Automate :

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/upload" \
-F "file=@/path/to/apk/file"

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" ^
-X POST "https://api-cloud.browserstack.com/app-automate/upload" ^
-F "file=@/path/to/apk/file"

Ensure that @ symbol is prepended to the file path in the above request. A sample response for the above request is shown below:

{
    "app_url" : "bs://j3c874f21852ba57957a3fdc33f47514288c4ba4"
}

Please note the app_url value returned in the API response (bs://j3c874..... in the above example). We will use this value to set the application under test while configuring the test later on.

3. Configure and run your first test

Setup your project

Clone the JUnit sample integration code from our GitHub repository.

git clone https://github.com/browserstack/junit-appium-app-browserstack.git

Next, execute the following commands to install required dependencies:

# Test an android app
cd android/junit4-examples
mvn clean

# Test an iOS app
cd ios/junit4-examples
mvn clean

This will install requisite dependencies including Appium’s Java client library :

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
        <dependency>
            <groupId>commons-io</groupId>
            <artifactId>commons-io</artifactId>
            <version>1.3.2</version>
        </dependency>
        <dependency>
            <groupId>org.seleniumhq.selenium</groupId>
            <artifactId>selenium-java</artifactId>
            <version>3.141.59</version>
        </dependency>
        <dependency>
            <groupId>io.appium</groupId>
            <artifactId>java-client</artifactId>
            <version>7.0.0</version>
        </dependency>
        <dependency>
            <groupId>com.browserstack</groupId>
            <artifactId>browserstack-local-java</artifactId>
            <version>1.0.3</version>
        </dependency>
        <dependency>
            <groupId>com.googlecode.json-simple</groupId>
            <artifactId>json-simple</artifactId>
            <version>1.1.1</version>
        </dependency>
    </dependencies>

Configure Appium’s desired capabilities

Desired capabilities are a series of key-value pairs that allow you to configure your Appium tests on BrowserStack. The following capabilities are required :

• app capability : Its used to specify your uploaded app that will be installed on device during test execution. Use the app_url obtained in Upload your App section to set its value.
• device capability : Its used to specify the BrowserStack device you want to run the test on.

In the JUnit sample integration code, Appium’s desired capabilities are defined in the first.conf.json file located in the junit4-examples/src/test/resources/com/browserstack/run_first_test directory :

{
    "server": "hub-cloud.browserstack.com",
    "username": "YOUR_USERNAME",
    "access_key": "YOUR_ACCESS_KEY",
  
    "capabilities": {
      "project": "First Junit4 Android Project",
      "build": "Junit4 Android First",
      "name": "first_test",
      "browserstack.debug": true,
      "app": "bs://<app-id>"
    },
    "environments": [{
      "device": "Google Pixel 3",
      "os_version":  "9.0"
    }]
}

{
    "server": "hub-cloud.browserstack.com",
    "username": "YOUR_USERNAME",
    "access_key": "YOUR_ACCESS_KEY",
  
    "capabilities": {
      "project": "First Junit4 iOS Project",
      "build": "Junit4 iOS First",
      "name": "first_test",
      "browserstack.debug": true,
      "app": "bs://<app-id>"
    },
    "environments": [{
      "device": "iPhone 11 Pro",
      "os_version":  "13"
    }]
}

Create remote Webdriver

Once you have configured desired capabilities, you can initialize an Appium webdriver to test remotely on BrowserStack. In order to do so, you need to use a remote BrowserStack URL along with your BrowserStack access credentials.

In the JUnit sample integration code, the remote Webdriver is initialised in the BrowserStackJUnitTest.java file located in the junit4-examples/src/test/java/com/browserstack/run_first_test directory as shown below :

//...

// Initialize the remote Webdriver using BrowserStack remote URL access credentials
// and desired capabilities defined above
driver = new AndroidDriver (
  new URL("http://"+username+":"+accessKey+"@"+config.get("server")+"/wd/hub"), capabilities);
  
//...

//...

// Initialize the remote Webdriver using BrowserStack remote URL access credentials
// and desired capabilities defined above
driver = new IOSDriver (
    new URL("http://"+username+":"+accessKey+"@"+config.get("server")+"/wd/hub"), capabilities);

//...

Setup your test-case

This step will help you setup your first test case with JUnit framework. In the JUnit sample integration code, we have provided a sample test-case in junit4-examples/src/test/java/com/browserstack/run_first_test directory for BrowserStack’s sample apps. If you are testing your own app, please modify the test case accordingly.

// imports...

public class FirstTest extends BrowserStackJUnitTest {
  @Test
  public void test() throws Exception {
    AndroidElement searchElement = (AndroidElement) new WebDriverWait(driver, 30)
    .until(ExpectedConditions.elementToBeClickable(
          MobileBy.AccessibilityId("Search Wikipedia")));
    searchElement.click();

    AndroidElement insertTextElement = (AndroidElement) new WebDriverWait(driver, 30)
    .until(ExpectedConditions.elementToBeClickable(
          MobileBy.id("org.wikipedia.alpha:id/search_src_text")));
    insertTextElement.sendKeys("BrowserStack");

    Thread.sleep(5000);

    List<AndroidElement> allProductsName = 
    driver.findElementsByClassName("android.widget.TextView");
    assertTrue(allProductsName.size() > 0);
  }
}

// imports...

public class FirstTest extends BrowserStackJUnitTest {
  @Test
  public void test() throws Exception {

    IOSElement textButton = (IOSElement) new WebDriverWait(driver, 30).until(
        ExpectedConditions.elementToBeClickable(
          MobileBy.AccessibilityId("Text Button")));
    textButton.click();

    IOSElement textInput = (IOSElement) new WebDriverWait(driver, 30).until(
        ExpectedConditions.elementToBeClickable(
          MobileBy.AccessibilityId("Text Input")));
    textInput.sendKeys("hello@browserstack.com" + "\n");

    Thread.sleep(5000);

    IOSElement textOutput = (IOSElement) new WebDriverWait(driver, 30).until(
        ExpectedConditions.elementToBeClickable(
          MobileBy.AccessibilityId("Text Output")));

    assertEquals(textOutput.getText(),"hello@browserstack.com");
  }
}

Run the test

You are ready to run your first JUnit test on BrowserStack. In the JUnit sample integration code, switch to junit4-examples/ directory, and run the test using command :

# Run using maven
mvn test -P first

4. View test execution results

You can access the test execution results, and debugging information such as video recording, network and device logs on App Automate dashboard or using our REST APIs.

What’s next

Congratulations! You just ran your first test on App Automate. Next, you can learn to :

• Run tests in parallel - Speed up test execution by running tests simultaneously across multiple BrowserStack devices
• Use Local testing - Test apps that access resources hosted on your development or testing environments

Need some help?

If you have any queries, please get in touch with us.