Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/appiumtestdistribution/appiumtestdistribution
A tool for running android and iOS appium tests in parallel across devices... U like it STAR it !
https://github.com/appiumtestdistribution/appiumtestdistribution
android appium appium-ios automation browserstack cloudtesting cucumber cucumberappium mp4box parallel parallel-computing parallel-ios parallelappium parallelappiumandroid parallelappiumios saucelabs testng
Last synced: 2 days ago
JSON representation
A tool for running android and iOS appium tests in parallel across devices... U like it STAR it !
- Host: GitHub
- URL: https://github.com/appiumtestdistribution/appiumtestdistribution
- Owner: AppiumTestDistribution
- License: mit
- Created: 2015-08-18T16:22:15.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2024-05-19T05:33:35.000Z (7 months ago)
- Last Synced: 2024-10-29T15:18:39.360Z (about 2 months ago)
- Topics: android, appium, appium-ios, automation, browserstack, cloudtesting, cucumber, cucumberappium, mp4box, parallel, parallel-computing, parallel-ios, parallelappium, parallelappiumandroid, parallelappiumios, saucelabs, testng
- Language: Java
- Homepage: https://saikrishna321.github.io/
- Size: 109 MB
- Stars: 1,001
- Watchers: 86
- Forks: 364
- Open Issues: 51
-
Metadata Files:
- Readme: README.md
- License: license
Awesome Lists containing this project
README
# Appium Parallel Execution for Android and iOS on Real Devices
[](https://github.com/saikrishna321/AppiumTestDistribution)
[](https://gitter.im/saikrishna321/AppiumTestDistribution?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://dl.circleci.com/status-badge/redirect/gh/AppiumTestDistribution/AppiumTestDistribution/tree/main)
[](https://github.com/saikrishna321/AppiumTestDistribution/stargazers)
[ ](https://github.com/saikrishna321/AppiumTestDistribution/pulls)
[](https://github.com/kirankalyan5/AppiumTestDistribution/network)
[](https://app.circleci.com/insights/github/AppiumTestDistribution/AppiumTestDistribution/workflows/build/overview?branch=main&reporting-window=last-24-hours&insights-snapshot=true)
## Thanks for support
Add the below dependencies in your pom.xml (Master)
### Please make sure you have installed Appium v2.0 and [appium-device-farm](https://github.com/AppiumTestDistribution/appium-device-farm) plugin
```
com.github.AppiumTestDistribution
AppiumTestDistribution
latest_commit
```
```
jitpack.io
https://jitpack.io
```
## [Maven Release Version](https://search.maven.org/artifact/com.github.saikrishna321/AppiumTestDistribution)
```
com.github.saikrishna321
AppiumTestDistribution
13.1.0
```
## [Prerequisites](https://github.com/saikrishna321/AppiumTestDistribution/wiki/Prerequisites)
## ReportPortal
Add LISTENERS=com.epam.reportportal.testng.ReportPortalTestNGListener to config.properties to send data to report portal.
### Sample Tests
Clone the project (https://github.com/saikrishna321/PageObjectPatternAppium)
If your application is cross-platform and you end up building a PageObjectPattern Framework. Then you can also run those tests across Android and iOS devices connected to the same Mac OSX Host.
(e.g. If you have 3 Android and 3 iOS devices connected to the same machine, you will be able to execute these tests parallel on both platforms)
## [Configure-tests-for-TestNG](https://github.com/saikrishna321/AppiumTestDistribution/wiki/Configure-tests-for-TestNG)
## [Configure-tests-for-Cucumber, using teswiz](https://github.com/AppiumTestDistribution/AppiumTestDistribution/wiki/Configure%E2%80%90tests%E2%80%90for%E2%80%90Cucumber,-using-teswiz)
## [Configure-tests-for-Sauce](https://github.com/AppiumTestDistribution/AppiumTestDistribution/wiki/Configure-test-for-Cloud-Sauce)
## [Configure-tests-for-Browserstack](https://github.com/AppiumTestDistribution/AppiumTestDistribution/wiki/Configure-test-for-BrowserStack-cloud)
## [Configure-tests-for-LambdaTest](https://github.com/AppiumTestDistribution/AppiumTestDistribution/wiki/Configure-test-for-LambdaTest-cloud)
## [Customize Tests](https://github.com/saikrishna321/AppiumTestDistribution/wiki/Customize-Tests)
## [Tips](https://github.com/saikrishna321/AppiumTestDistribution/wiki/Tips)
## Video log Prerequisites
* Install ffmpeg. [OSX](https://trac.ffmpeg.org/wiki/CompilationGuide/MacOSX)
* ```$ brew update```
* ```$ brew install ffmpeg```
* `
* Install ffmpeg. [windows]( https://ffmpeg.org/download.html#build-windows)
## Runner
Videos will be logged for failure tests
VIDEO_LOGS="true" mvn clean -Dtest=Runner test
## Credits
Thanks to
* [@thote](https://github.com/thote) and [@jaydeepc](https://github.com/jaydeepc) for the motivation.
* [@SrinivasanTarget](https://github.com/SrinivasanTarget) for contributing on iOS parallel.
* [@anandbagmar](https://github.com/anandbagmar) for fixing cucumber support.
### Parallel Run
[](https://www.youtube.com/watch?v=X2OaLAqikMI&t=57s)
## FAQ
**Q. Can I automate application which I already have installed/downloaded from App store?**
A. With XCUITest framework, that is available from iOS version 9.3, it's possible to execute Native (WebViews content would not be reachable) application using its bundle id.
In order to get information about bundle id of pre-installed application:
* connect device with application installed;
* run ideviceinstaller -l or ideviceinstaller -l -u {udid of the device} in case more than one device connected to the host;
* in the list - find name of the application followed by its bundle id.
After that, instead of `app` capability `bundleId` should be used with application's bundle id as a value.
Since Appium still needs WDA to be built and deployed on the real device - valid certificate and provisioning profile will be needed. More information could be found [here](https://github.com/imurchie/appium-xcuitest-driver/blob/isaac-rs/docs/real-device-config.md)
In case the tests need to interact with WebViews and/or iOS version has no support of XCUITest - Appium would need instruments application which is in debug mode. It will not work with any application which is not in debug mode. Read more about it [here](https://discuss.appium.io/t/appium-ios-app-testing/105/8)
**Q. Does this framework support running multiple iOS simulators?**
A. Yes, currently Appium does support multiple simulators with latest 1.6.6.beta with Xcode9-beta.
**Q. Unable to instrument application or instruments crashed on start up?**
A. Below are few possible causes
* (app/ipa) is not on debug mode.
* (app) targeted to simulator will not work with real device and vice versa
* Check device's developer option in settings.
**Q. Unable to install application during automation?**
A. A quick solution would be to try to install the application using "ideviceinstaller -i ipa_name". If that does not work, check app is built with a valid provisioning profile.
**Q. Can I run tests on iOS app for which I have source code**(e.g:"[Wordpress](https://github.com/wordpress-mobile/WordPress-iOS.git)") **on real devices?**
A. Yes, with a valid provisioning profile, this app can be installed on your device.
(Note: The application must be signed with a valid developer certificate and your device should be added to the provisioning profile)
## Organizations :blue_heart:
ThoughtWorks | CeX | Travelstart
:-------------------------:|:-------------------------:|:-------------------------:
[](https://www.thoughtworks.com) | [](https://in.webuy.com/) | [](http://www.travelstart.com/)
Jio India | M800 | Reward Gateway
:-:|:-:|:-:
[](https://www.jio.com/) | [](http://www.m800.com/) | [](https://www.rewardgateway.com/)
dahmakan|
:-------------------------:|
[
](https://www.dahmakan.com/)
## License
AppiumTestDistribution is released under [](https://opensource.org/licenses/MIT)
Copyright (c) 2023 AppiumTestDistribution