Skip to content

Include app URL placeholder | Update readme #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Aug 8, 2017
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 12 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# testng-browserstack
# testng-appium-app-browserstack

[TestNG](http://testng.org) Integration with BrowserStack.

Expand All @@ -12,21 +12,27 @@

## Running your tests

- 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
- To run a single test, run `mvn test -P single`
- To run parallel tests, run `mvn test -P parallel`
- To run local tests, run `mvn test -P local`

## Notes
* You can view your test results on the [BrowserStack Automate dashboard](https://www.browserstack.com/automate)
* To test on a different set of browsers, check out our [platform configurator](https://www.browserstack.com/automate/java#setting-os-and-browser)
* Refer [Get Started](https://www.browserstack.com/app-automate/get-started#getting-started) document to configure the capabilities
* You can export the environment variables for the Username and Access Key of your BrowserStack account

```
export BROWSERSTACK_USERNAME=<browserstack-username> &&
export BROWSERSTACK_ACCESS_KEY=<browserstack-access-key>
```
## Additional Resources
* [Documentation for writing Automate test scripts in Java](https://www.browserstack.com/automate/java)
* [Customizing your tests on BrowserStack](https://www.browserstack.com/automate/capabilities)
* [Browsers & mobile devices for selenium testing on BrowserStack](https://www.browserstack.com/list-of-browsers-and-platforms?product=automate)
* [Using REST API to access information about your tests via the command-line interface](https://www.browserstack.com/automate/rest-api)
* [Getting Started with App Automate](https://www.browserstack.com/app-automate/get-started)
2 changes: 1 addition & 1 deletion src/test/resources/conf/local.conf.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
"browserstack.debug": true,
"browserstack.local": true,
"realMobile": true,
"app": "bs://9a04c63690c3c532341a22a69a916017536ec165"
"app": "bs://<hashed app-id>"
},

"environments": {
Expand Down
2 changes: 1 addition & 1 deletion src/test/resources/conf/parallel.conf.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
"name": "parallel_appium_test",
"browserstack.debug": true,
"realMobile": true,
"app": "bs://d747176bd63686393208fea69d1963ec9c225080"
"app": "bs://<hashed app-id>"
},

"environments": {
Expand Down
2 changes: 1 addition & 1 deletion src/test/resources/conf/single.conf.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
"name": "single_appium_test",
"browserstack.debug": true,
"realMobile": true,
"app": "bs://3fc0a1f5a158e935ad806b97288f4b24e11ebcc4"
"app": "bs://<hashed app-id>"
},

"environments": {
Expand Down
2 changes: 1 addition & 1 deletion src/test/resources/conf/suite.conf.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
"name": "suite_appium_test",
"browserstack.debug": true,
"realMobile": true,
"app": "bs://d747176bd63686393208fea69d1963ec9c225080"
"app": "bs://<hashed app-id>"
},

"environments": {
Expand Down