kskrishnan/AppiumTestDistribution

A tool for running android and iOS appium tests in parallel across devices... U like it STAR it ! http://saikrishna321.github.io/AppiumTestDistribution

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.kskrishnan:AppiumTestDistribution:1.0.2'
	}

	dependencies {
		implementation("com.github.kskrishnan:AppiumTestDistribution:1.0.2")
	}

	<dependency>
	    <groupId>com.github.kskrishnan</groupId>
	    <artifactId>AppiumTestDistribution</artifactId>
	    <version>1.0.2</version>
	</dependency>


                            
    libraryDependencies += "com.github.kskrishnan" % "AppiumTestDistribution" % "1.0.2"


                            
    :dependencies [[com.github.kskrishnan/AppiumTestDistribution "1.0.2"]]

Readme

Appium Parallel Execution for Android and iOS on Real Devices

alt tag

Add the below dependencies in your pom.xml

<dependency>
    <groupId>com.github.saikrishna321</groupId>
    <artifactId>AppiumTestDistribution</artifactId>
    <version>5.0.0</version>
</dependency>

<repositories>
        <repository>
            <id>jitpack.io</id>
            <url>https://jitpack.io</url>
        </repository>
</repositories>

##Prerequisites

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)

##Configure-tests-for-TestNG

##Configure-tests-for-Cucumber

##Customize Tests

##Tips

##Credits Thanks to

@thote and @jaydeepc for the motivation.
@SrinivasanTarget for contributing on iOS parallel.
@temyers for letting us use the cucumber-jvm-parallel-plugin(https://github.com/temyers/cucumber-jvm-parallel-plugin) as part of framework which helps generating a Cucumber JUnit or TestNG runner for each feature file.

###Reports

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

###TestRunning in Distributed Way

##WIP iOS WebTest using Safari

##FAQ Q. Can I automate application which I already have installed/ downloaded from App store?

A. No, Appium can only 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. No, Currently Appium does not support multiple simulators, it will be supported in Appium's future releases.

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)

License

AppiumTestDistribution is released under GNU Public License version 3.0