A tool for running android and iOS appium tests in parallel across devices... U like it STAR it !
Clone or download
Failed to load latest commit information.
.settings fixed broken submodule Apr 22, 2016
caps Set up CI with Azure Pipelines (#386) Oct 6, 2018
image added logo Jun 17, 2018
src initialiseDriver based on capabilities received Oct 8, 2018
webContent/app Major Refactor (#191) May 31, 2017
.classpath Using some patterns in getting appium manager Feb 28, 2018
.gitignore Major Refactor (#191) May 31, 2017
.gitmodules removed cucumber parallel submodule Apr 22, 2016
.project initial commit Aug 18, 2015
AndroidCalculator.apk Handle Parallel Test with Single server session (#222) Sep 12, 2017
FA694F6C-6CBC-4F74-8947-F9993F5242C8 Refactor devicemanager (#240) Oct 31, 2017
LICENSE Create LICENSE Nov 7, 2016
README.md Set up CI with Azure Pipelines (#386) Oct 6, 2018
VodQAReactNative.zip Ios parallel sim (#212) Aug 11, 2017
_config.yml Set theme jekyll-theme-hacker Mar 24, 2018
azure-pipelines.yml Set up CI with Azure Pipelines (#386) Oct 6, 2018
bootdevice.sh Refactor devicemanager (#240) Oct 31, 2017
config.properties Report portal Integration (#360) Aug 30, 2018
credentials.json #66 added support to take multiple credentails May 28, 2016
extent.xml changed extent to V3 Nov 6, 2016
generate_report.sh Major Refactor (#191) May 31, 2017
google-style.xml Ios parallel sim (#212) Aug 11, 2017
nohup.out Refactor devicemanager (#240) Oct 31, 2017
pom.xml Report portal Integration (#360) Aug 30, 2018
screenshot_copy.sh Major Refactor (#191) May 31, 2017
testng.xml Major Refactor (#191) May 31, 2017



Appium Parallel Execution for Android and iOS on Real Devices

Open Source Love Join the chat at https://gitter.im/saikrishna321/AppiumTestDistribution Build Status Codacy Badge GitHub stars PRs Welcome GitHub forks

Add the below dependencies in your pom.xml (Master)



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 test parallel on both platforms)



Customize Tests


Video log Prerequisites


##Videos will be logged for failure tests
VIDEO_LOGS="true" mvn clean -Dtest=Runner test 


Thanks to


Your should see report file generated as ExtentReport.html under the target folder.

Parallel Run



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 it's 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 if more then 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

In case if test 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

Q. Is this framework supports to run multiple IOS simulators?

A. Yes, Currently Appium does support multiple simulators with latest 1.6.6.beta with Xcode9-beta.

Q. Unable to instruments 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 try to install the application using "ideviceinstaller -i ipa_name", if that does not work, check app is built with the valid provisioning profile.

Q. Can I run tests on iOS app for which I have source code(e.g:"Wordpress") 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 💙

ThoughtWorks CeX Travelstart
ThoughtWorks Cex Travelstart
Jio India M800 Reward Gateway
Jio M800 Reward


GNU Public License version 3.0 AppiumTestDistribution is released under GNU Public License version 3.0