diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..cb0ef2d --- /dev/null +++ b/.gitignore @@ -0,0 +1,10 @@ +*.png +target/ +local.log +.idea +*.iml +**/.DS_Store +**/.settings +.classpath +.project + diff --git a/README.md b/README.md index 446876b..c8321a1 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,132 @@ -App Automate Java Samples ---------------------- +# java-appium-app-browserstack -This repository contains code for Automated Native App tests using Appium in Java. Please feel free to clone the repo and use the example code. +This repository demonstrates how to run Appium Java tests on BrowserStack App Automate. -For frameworks integration with BrowserStack, refer to their individual repositories - +## Setup + +### Requirements + +1. Java 8+ + +- If Java is not installed, follow these instructions: + - For Windows, download latest java version from [here](https://java.com/en/download/) 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](https://java.com/en/download/) + +2. Maven + + - If Maven is not downloaded, download it from [here](https://maven.apache.org/download.cgi) + - For installation, follow the instructions [here](https://maven.apache.org/install.html) + +### Install the dependencies + +To install the dependencies, run the following command in the project's base folder + +```cmd +mvn clean install +``` + +## Getting Started + +Getting Started with Appium tests in Java on BrowserStack couldn't be easier! + +### Run your first test : + +**1. Upload your Android or iOS 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 : + +``` +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. Please note the `app_url` value returned in the API response. We will use this to set the application under test while configuring the test later on. + +**Note**: If you do not have an .apk or .ipa file and are looking to simply try App Automate, you can download and test using our [sample Android app](https://www.browserstack.com/app-automate/sample-apps/android/WikipediaSample.apk) or [sample iOS app](https://www.browserstack.com/app-automate/sample-apps/ios/BStackSampleApp.ipa). + +**2. Configure and run your first test** + +Open `BrowserStackSample.java` file in the `android` directory or `ios` directory : + +- Replace `YOUR_USERNAME` & `YOUR_ACCESS_KEY` with your BrowserStack access credentials. Get your BrowserStack access credentials from [here](https://www.browserstack.com/accounts/settings) + +- Replace `bs://` with the URL obtained from app upload step + +- Set the device and OS version + +- If you have uploaded your own app update the test case + +- To run the test, use the following command in the base directory : + + - For Android test, run + + ```cmd + mvn test -P android-first-test + ``` + + - For iOS test, run + + ```cmd + mvn test -P ios-first-test + ``` + +- You can access the test execution results, and debugging information such as video recording, network logs on [App Automate dashboard](https://app-automate.browserstack.com/dashboard) + +--- + +### Use Local testing for apps that access resources hosted in development or testing environments : + +**1. Upoad your Android or iOS App** + +Upload your Android app (.apk or .aab file) or iOS app (.ipa file) that access resources hosted on your internal or test environments to BrowserStack servers using our REST API. Here is an example cURL request : + +``` +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. Please note the `app_url` value returned in the API response. We will use this to set the application under test while configuring the test later on. + +**Note**: If you do not have an .apk or .ipa file and are looking to simply try App Automate, you can download and test using our [sample Android Local app](https://www.browserstack.com/app-automate/sample-apps/android/LocalSample.apk) or [sample iOS Local app](https://www.browserstack.com/app-automate/sample-apps/ios/LocalSample.ipa). + +**2. Configure and run your local test** + +Open `BrowserStackSampleLocal.java` file in the `android` or `ios` directory : + +- Replace `YOUR_USERNAME` & `YOUR_ACCESS_KEY` with your BrowserStack access credentials. Get your BrowserStack access credentials from [here](https://www.browserstack.com/accounts/settings) + +- Replace `bs://` with the URL obtained from app upload step + +- Set the device and OS version + +- Ensure that `browserstack.local` capability is set to `true`. Within the test script, there is code snippet that automatically establishes Local Testing connection to BrowserStack servers using Java binding for BrowserStack Local. + +- If you have uploaded your own app update the test case + +- To run the test, use the following command in the base directory : + + - For Android test, run + + ```cmd + mvn test -P android-local-test + ``` + + - For iOS test, run + + ```cmd + mvn test -P ios-local-test + ``` + +- You can access the test execution results, and debugging information such as video recording, network logs on [App Automate dashboard](https://app-automate.browserstack.com/dashboard) + + +## Integration with other Java frameworks - [JUnit](https://github.com/browserstack/junit-appium-app-browserstack) -- [TestNg](https://github.com/browserstack/testng-appium-app-browserstack) \ No newline at end of file +- [TestNg](https://github.com/browserstack/testng-appium-app-browserstack) + +## Getting Help + +If you are running into any issues or have any queries, please check [Browserstack Support page](https://www.browserstack.com/support/app-automate) or [get in touch with us](https://www.browserstack.com/contact?ref=help). diff --git a/android/BrowserStackAndroid.java b/android/BrowserStackAndroid.java deleted file mode 100644 index 45eb56d..0000000 --- a/android/BrowserStackAndroid.java +++ /dev/null @@ -1,39 +0,0 @@ -import java.net.URL; -import java.util.List; -import java.net.MalformedURLException; - -import io.appium.java_client.MobileBy; -import io.appium.java_client.android.AndroidDriver; -import io.appium.java_client.android.AndroidElement; - -import org.openqa.selenium.support.ui.ExpectedConditions; -import org.openqa.selenium.support.ui.WebDriverWait; -import org.openqa.selenium.remote.DesiredCapabilities; - -public class BrowserStackAndroid { - - public static String accessKey = "BROWSERSTACK_USERNAME"; - public static String userName = "BROWSERSTACK_ACCESS_KEY"; - - public static void main(String args[]) throws MalformedURLException, InterruptedException { - DesiredCapabilities capabilities = new DesiredCapabilities(); - - capabilities.setCapability("device", "Samsung Galaxy S7"); - capabilities.setCapability("app", "bs://"); - - AndroidDriver driver = new AndroidDriver(new URL("https://"+userName+":"+accessKey+"@hub.browserstack.com/wd/hub"), capabilities); - - 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 allProductsName = driver.findElementsByClassName("android.widget.TextView"); - assert(allProductsName.size() > 0); - - driver.quit(); - } -} diff --git a/android/LocalSampleAndroid.java b/android/LocalSampleAndroid.java deleted file mode 100644 index 28483d9..0000000 --- a/android/LocalSampleAndroid.java +++ /dev/null @@ -1,72 +0,0 @@ -import com.browserstack.local.Local; - -import java.net.URL; -import java.util.Map; -import java.util.List; -import java.util.HashMap; - -import io.appium.java_client.MobileBy; -import io.appium.java_client.android.AndroidDriver; -import io.appium.java_client.android.AndroidElement; - -import org.openqa.selenium.support.ui.ExpectedConditions; -import org.openqa.selenium.support.ui.WebDriverWait; -import org.openqa.selenium.remote.DesiredCapabilities; - - -public class LocalSampleAndroid { - private static Local localInstance; - public static String accessKey = "BROWSERSTACK_USERNAME"; - public static String userName = "BROWSERSTACK_ACCESS_KEY"; - - - public static void setupLocal() throws Exception { - localInstance = new Local(); - Map options = new HashMap(); - options.put("key", accessKey); - localInstance.start(options); - } - - public static void tearDownLocal() throws Exception { - localInstance.stop(); - } - - public static void main(String[] args) throws Exception { - setupLocal(); - - DesiredCapabilities capabilities = new DesiredCapabilities(); - - capabilities.setCapability("browserstack.local", true); - capabilities.setCapability("device", "Samsung Galaxy S7"); - capabilities.setCapability("app", "bs://"); - - AndroidDriver driver = new AndroidDriver(new URL("https://"+userName+":"+accessKey+"@hub.browserstack.com/wd/hub"), capabilities); - - AndroidElement searchElement = (AndroidElement) new WebDriverWait(driver, 30).until( - ExpectedConditions.elementToBeClickable(MobileBy.id("com.example.android.basicnetworking:id/test_action"))); - searchElement.click(); - AndroidElement insertTextElement = (AndroidElement) new WebDriverWait(driver, 30).until( - ExpectedConditions.elementToBeClickable(MobileBy.className("android.widget.TextView"))); - - AndroidElement testElement = null; - List allTextViewElements = driver.findElementsByClassName("android.widget.TextView"); - Thread.sleep(10); - for(AndroidElement textElement : allTextViewElements) { - if(textElement.getText().contains("The active connection is")) { - testElement = textElement; - } - } - - if(testElement == null) { - throw new Error("Cannot find the needed TextView element from app"); - } - String matchedString = testElement.getText(); - System.out.println(matchedString); - assert(matchedString.contains("The active connection is wifi")); - assert(matchedString.contains("Up and running")); - - driver.quit(); - - tearDownLocal(); - } -} diff --git a/android/README.md b/android/README.md deleted file mode 100644 index 76ca27c..0000000 --- a/android/README.md +++ /dev/null @@ -1,18 +0,0 @@ -## Running your tests -- Do remember to switch the USERNAME and ACCESS_KEY with your own browserstack credentials. -- Upload your Native App (.apk file) to BrowserStack servers using upload API: - - ``` - curl -u "username:accesskey" -X POST "https://api.browserstack.com/app-automate/upload" -F "file=@/path/to/app/file/Application-debug.apk" - ``` - -- If you do not have an .apk file and looking to simply try App Automate, [you can download our sample app and upload](https://www.browserstack.com/app-automate/sample-apps/android/WikipediaSample.apk) -to the BrowserStack servers using the above API. -- Update the desired capability "app" with the App URL returned from the above API call - -For running LocalSample tests, you can download `browserstack-local-java.jar` from [here](http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22browserstack-local-java%22). - -For frameworks integration with BrowserStack, refer to their individual repositories - - -- [JUnit](https://github.com/browserstack/junit-appium-app-browserstack) -- [TestNG](https://github.com/browserstack/testng-appium-app-browserstack) diff --git a/ios/README.md b/ios/README.md deleted file mode 100644 index 91485a6..0000000 --- a/ios/README.md +++ /dev/null @@ -1,18 +0,0 @@ -## Running your tests -- Do remember to switch the USERNAME and ACCESS_KEY with your own browserstack credentials. -- Upload your Native App (.ipa file) to BrowserStack servers using upload API: - - ``` - curl -u "username:accesskey" -X POST "https://api.browserstack.com/app-automate/upload" -F "file=@/path/to/app/file/Application-debug.ipa" - ``` - -- If you do not have an .ipa file and looking to simply try App Automate, [you can download our sample app and upload](https://www.browserstack.com/app-automate/sample-apps/ios/BStackSampleApp.ipa) -to the BrowserStack servers using the above API. -- Update the desired capability "app" with the App URL returned from the above API call - -For running LocalSample tests, you can download `browserstack-local-java.jar` from [here](http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22browserstack-local-java%22). - -For frameworks integration with BrowserStack, refer to their individual repositories - - -- [JUnit](https://github.com/browserstack/junit-appium-app-browserstack) -- [TestNG](https://github.com/browserstack/testng-appium-app-browserstack) \ No newline at end of file diff --git a/pom.xml b/pom.xml new file mode 100644 index 0000000..74fc8bd --- /dev/null +++ b/pom.xml @@ -0,0 +1,160 @@ + + 4.0.0 + com.browserstack + java-browserstack + 0.0.1-SNAPSHOT + java-browserstack + Java appium app browserstack + + + UTF-8 + 2.19.1 + + default + + + + + + commons-io + commons-io + 1.3.2 + + + io.appium + java-client + 7.0.0 + + + com.browserstack + browserstack-local-java + 1.0.3 + + + com.googlecode.json-simple + json-simple + 1.1.1 + + + + + + + org.apache.maven.plugins + maven-surefire-plugin + 2.22.2 + + + org.apache.maven.plugins + maven-compiler-plugin + 3.8.1 + + 1.8 + 1.8 + + + + + + + + android-first-test + + + + org.codehaus.mojo + exec-maven-plugin + 1.1.1 + + + test + + java + + + android.BrowserStackSample + test + + + + + + + + + android-local-test + + + + org.codehaus.mojo + exec-maven-plugin + 1.1.1 + + + test + + java + + + android.BrowserStackSampleLocal + test + + + + + + + + + ios-first-test + + + + org.codehaus.mojo + exec-maven-plugin + 1.1.1 + + + test + + java + + + ios.BrowserStackSample + test + + + + + + + + + ios-local-test + + + + org.codehaus.mojo + exec-maven-plugin + 1.1.1 + + + test + + java + + + ios.BrowserStackSampleLocal + test + + + + + + + + + + \ No newline at end of file diff --git a/src/test/java/android/BrowserStackSample.java b/src/test/java/android/BrowserStackSample.java new file mode 100644 index 0000000..4deea4f --- /dev/null +++ b/src/test/java/android/BrowserStackSample.java @@ -0,0 +1,68 @@ +package android; + +import java.net.URL; +import java.util.List; +import java.util.function.Function; +import java.net.MalformedURLException; + +import io.appium.java_client.MobileBy; +import io.appium.java_client.android.AndroidDriver; +import io.appium.java_client.android.AndroidElement; + +import org.openqa.selenium.support.ui.ExpectedConditions; +import org.openqa.selenium.support.ui.WebDriverWait; +import org.openqa.selenium.WebDriver; +import org.openqa.selenium.remote.DesiredCapabilities; + + +public class BrowserStackSample { + + public static void main(String[] args) throws MalformedURLException, InterruptedException { + + DesiredCapabilities caps = new DesiredCapabilities(); + + // Set your access credentials + caps.setCapability("browserstack.user", "YOUR_USERNAME"); + caps.setCapability("browserstack.key", "YOUR_ACCESS_KEY"); + + // Set URL of the application under test + caps.setCapability("app", "bs://"); + + // Specify device and os_version for testing + caps.setCapability("device", "Google Pixel 3"); + caps.setCapability("os_version", "9.0"); + + // Set other BrowserStack capabilities + caps.setCapability("project", "First Java Project"); + caps.setCapability("build", "Java Android"); + caps.setCapability("name", "first_test"); + + + // Initialise the remote Webdriver using BrowserStack remote URL + // and desired capabilities defined above + AndroidDriver driver = new AndroidDriver( + new URL("http://hub.browserstack.com/wd/hub"), caps); + + + // Test case for the BrowserStack sample Android app. + // If you have uploaded your app, update the test case here. + 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 allProductsName = driver.findElementsByClassName( + "android.widget.TextView"); + assert(allProductsName.size() > 0); + + + // Invoke driver.quit() after the test is done to indicate that the test is completed. + driver.quit(); + + } + +} diff --git a/src/test/java/android/BrowserStackSampleLocal.java b/src/test/java/android/BrowserStackSampleLocal.java new file mode 100644 index 0000000..cb6f71e --- /dev/null +++ b/src/test/java/android/BrowserStackSampleLocal.java @@ -0,0 +1,90 @@ +package android; + +import com.browserstack.local.Local; +import java.net.URL; import java.util.*; +import io.appium.java_client.MobileBy; import io.appium.java_client.android.*; +import org.openqa.selenium.support.ui.*;import org.openqa.selenium.remote.*; + +public class BrowserStackSampleLocal { + + private static Local localInstance; + public static String userName = "YOUR_USERNAME"; + public static String accessKey = "YOUR_ACCESS_KEY"; + + + public static void setupLocal() throws Exception { + localInstance = new Local(); + Map options = new HashMap(); + options.put("key", accessKey); + localInstance.start(options); + } + + public static void tearDownLocal() throws Exception { + localInstance.stop(); + } + + public static void main(String[] args) throws Exception { + // Start the BrowserStack Local binary + setupLocal(); + + DesiredCapabilities capabilities = new DesiredCapabilities(); + + // Set your access credentials + capabilities.setCapability("browserstack.user", userName); + capabilities.setCapability("browserstack.key", accessKey); + + // Set URL of the application under test + capabilities.setCapability("app", "bs://"); + + // Specify device and os_version for testing + capabilities.setCapability("device", "Google Pixel 3"); + capabilities.setCapability("os_version", "9.0"); + + // Set the browserstack.local capability to true + capabilities.setCapability("browserstack.local", true); + + // Set other BrowserStack capabilities + capabilities.setCapability("project", "First Java Project"); + capabilities.setCapability("build", "Java Android Local"); + capabilities.setCapability("name", "local_test"); + + + // Initialise the remote Webdriver using BrowserStack remote URL + // and desired capabilities defined above + AndroidDriver driver = new AndroidDriver( + new URL("http://hub.browserstack.com/wd/hub"), capabilities); + + // Test case for the BrowserStack sample Android Local app. + // If you have uploaded your app, update the test case here. + AndroidElement searchElement = (AndroidElement) new WebDriverWait(driver, 30).until( + ExpectedConditions.elementToBeClickable(MobileBy.id("com.example.android.basicnetworking:id/test_action"))); + searchElement.click(); + AndroidElement insertTextElement = (AndroidElement) new WebDriverWait(driver, 30).until( + ExpectedConditions.elementToBeClickable(MobileBy.className("android.widget.TextView"))); + + AndroidElement testElement = null; + List allTextViewElements = driver.findElementsByClassName("android.widget.TextView"); + Thread.sleep(10); + for(AndroidElement textElement : allTextViewElements) { + if(textElement.getText().contains("The active connection is")) { + testElement = textElement; + } + } + + if(testElement == null) { + throw new Error("Cannot find the needed TextView element from app"); + } + String matchedString = testElement.getText(); + System.out.println(matchedString); + assert(matchedString.contains("The active connection is wifi")); + assert(matchedString.contains("Up and running")); + + // Invoke driver.quit() after the test is done to indicate that the test is completed. + driver.quit(); + + // Stop the BrowserStack Local binary + tearDownLocal(); + + } + +} diff --git a/ios/BrowserStackIOS.java b/src/test/java/ios/BrowserStackSample.java similarity index 50% rename from ios/BrowserStackIOS.java rename to src/test/java/ios/BrowserStackSample.java index 48b2799..841a807 100644 --- a/ios/BrowserStackIOS.java +++ b/src/test/java/ios/BrowserStackSample.java @@ -1,3 +1,5 @@ +package ios; + import java.net.URL; import java.util.List; import java.net.MalformedURLException; @@ -10,36 +12,53 @@ import io.appium.java_client.ios.IOSDriver; import io.appium.java_client.ios.IOSElement; +public class BrowserStackSample { -public class BrowserStackIOS { - public static String accessKey = "BROWSERSTACK_USERNAME"; - public static String userName = "BROWSERSTACK_ACCESS_KEY"; - - public static void main(String args[]) throws MalformedURLException, InterruptedException { - DesiredCapabilities caps = new DesiredCapabilities(); - - caps.setCapability("device", "iPhone 7 Plus"); - caps.setCapability("app", "bs://"); - - IOSDriver driver = new IOSDriver(new URL("http://"+userName+":"+accessKey+"@hub-cloud.browserstack.com/wd/hub"), caps); + public static void main(String[] args) throws MalformedURLException, InterruptedException { + DesiredCapabilities caps = new DesiredCapabilities(); + + // Set your access credentials + caps.setCapability("browserstack.user", "YOUR_USERNAME"); + caps.setCapability("browserstack.key", "YOUR_ACCESS_KEY"); + + // Set URL of the application under test + caps.setCapability("app", "bs://"); + + // Specify device and os_version for testing + caps.setCapability("device", "iPhone 11 Pro"); + caps.setCapability("os_version", "13"); + + // Set other BrowserStack capabilities + caps.setCapability("project", "First Java Project"); + caps.setCapability("build", "Java iOS"); + caps.setCapability("name", "first_test"); + + + // Initialise the remote Webdriver using BrowserStack remote URL + // and desired capabilities defined above + IOSDriver driver = new IOSDriver( + new URL("http://hub-cloud.browserstack.com/wd/hub"), caps); + + // Test case for the BrowserStack sample iOS app. + // If you have uploaded your app, update the test case here. 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"); - Thread.sleep(5000); - IOSElement textOutput = (IOSElement) new WebDriverWait(driver, 30).until( ExpectedConditions.elementToBeClickable(MobileBy.AccessibilityId("Text Output"))); - if(textOutput != null && textOutput.getText().equals("hello@browserstack.com")) assert(true); else assert(false); + // Invoke driver.quit() after the test is done to indicate that the test is completed. driver.quit(); - } + + } + } diff --git a/ios/LocalSampleIOS.java b/src/test/java/ios/BrowserStackSampleLocal.java similarity index 51% rename from ios/LocalSampleIOS.java rename to src/test/java/ios/BrowserStackSampleLocal.java index bb3f889..4a6daf4 100644 --- a/ios/LocalSampleIOS.java +++ b/src/test/java/ios/BrowserStackSampleLocal.java @@ -1,28 +1,17 @@ -import com.browserstack.local.Local; +package ios; -import java.net.URL; -import java.io.File; -import java.util.Map; -import java.util.HashMap; +import com.browserstack.local.Local; +import java.net.URL; import java.io.File; import java.util.*; import org.apache.commons.io.FileUtils; +import io.appium.java_client.MobileBy; import io.appium.java_client.ios.*; +import org.openqa.selenium.*; +import org.openqa.selenium.support.ui.*;import org.openqa.selenium.remote.*; -import io.appium.java_client.MobileBy; -import io.appium.java_client.ios.IOSDriver; -import io.appium.java_client.ios.IOSElement; - -import org.openqa.selenium.WebDriver; -import org.openqa.selenium.OutputType; -import org.openqa.selenium.TakesScreenshot; -import org.openqa.selenium.support.ui.WebDriverWait; -import org.openqa.selenium.remote.DesiredCapabilities; -import org.openqa.selenium.support.ui.ExpectedCondition; -import org.openqa.selenium.support.ui.ExpectedConditions; - - -public class LocalSampleIOS { +public class BrowserStackSampleLocal { + private static Local localInstance; - public static String accessKey = "BROWSERSTACK_USERNAME"; - public static String userName = "BROWSERSTACK_ACCESS_KEY"; + public static String userName = "YOUR_USERNAME"; + public static String accessKey = "YOUR_ACCESS_KEY"; public static void setupLocal() throws Exception { @@ -36,17 +25,39 @@ public static void tearDownLocal() throws Exception { localInstance.stop(); } - public static void main(String[] args) throws Exception { + + public static void main(String[] args) throws Exception { + // Start the BrowserStack Local binary setupLocal(); DesiredCapabilities capabilities = new DesiredCapabilities(); - capabilities.setCapability("browserstack.local", true); - capabilities.setCapability("device", "iPhone 7"); - capabilities.setCapability("app", "bs://"); - - IOSDriver driver = new IOSDriver(new URL("http://"+userName+":"+accessKey+"@hub.browserstack.com/wd/hub"), capabilities); - + // Set your access credentials + capabilities.setCapability("browserstack.user", userName); + capabilities.setCapability("browserstack.key", accessKey); + + // Set URL of the application under test + capabilities.setCapability("app", "bs://"); + + // Specify device and os_version for testing + capabilities.setCapability("device", "iPhone 11 Pro"); + capabilities.setCapability("os_version", "13"); + + // Set the browserstack.local capability to true + capabilities.setCapability("browserstack.local", true); + + // Set other BrowserStack capabilities + capabilities.setCapability("project", "First Java Project"); + capabilities.setCapability("build", "Java iOS Local"); + capabilities.setCapability("name", "local_test"); + + // Initialise the remote Webdriver using BrowserStack remote URL + // and desired capabilities defined above + IOSDriver driver = new IOSDriver( + new URL("http://hub.browserstack.com/wd/hub"), capabilities); + + // Test case for the BrowserStack sample iOS Local app. + // If you have uploaded your app, update the test case here. IOSElement testButton = (IOSElement) new WebDriverWait(driver, 30).until( ExpectedConditions.elementToBeClickable(MobileBy.AccessibilityId("TestBrowserStackLocal"))); testButton.click(); @@ -73,8 +84,12 @@ public Boolean apply(WebDriver d) { String expectedString = "Up and running"; assert(resultString.contains(expectedString.toLowerCase())); + // Invoke driver.quit() after the test is done to indicate that the test is completed. driver.quit(); - + + // Stop the BrowserStack Local binary tearDownLocal(); - } + + } + }