CD2H gitForager

awslabs/aws-device-farm-appium-tests-for-sample-app

Name: aws-device-farm-appium-tests-for-sample-app

Owner: Amazon Web Services - Labs

Owner: AWS Samples

Description: AWS Device Farm Appium tests

Created: 2015-08-07 23:19:53.0

Updated: 2018-01-14 12:26:40.0

Pushed: 2017-10-24 22:15:19.0

Homepage:

Size: 217

Language: Java

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Appium Sample Tests for AWS Device Farm Sample App

This is a collection of example Appium TestNG tests written for the AWS Device Farm Android sample app. Please use these tests as a reference for your own AWS Device Farm Appium TestNG tests.

This test suite uses the Appium page model in order to separate the tests from the logic.

Android

Getting Started

Follow the official Appium getting started guide and install the Appium server and dependencies.

AWS Device Farm supports Appium version 1.6.5. Using a different version locally may cause unexpected results when running Appium tests on AWS Device Farm.
In order to use 1.6.5, download Appium through NPM with this command:
```
install -g appium@1.6.5
```
Verify that you have Appium installed with this command:
```
um -v
```
You should get “1.6.5” as the output

Creating a new Java Appium Test Project Using Maven

Create a new Maven project using a Java IDE. The example in this tutorial is for IntelliJ IDEA Community Edition.

Set up your POM file using the official AWS Device Farm documentation for TestNG

You will need the following dependencies in your POM file

endencies>
<dependency>
    <groupId>org.testng</groupId>
    <artifactId>testng</artifactId>
    <version>6.11</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>io.appium</groupId>
    <artifactId>java-client</artifactId>
    <version>4.1.2</version>
</dependency>
pendencies>

Running Your Tests Locally

First, make sure that you have followed all the steps in the Appium getting started guide.

Use the script start-appium-android.sh to run the Appium server locally. Once the server has started, run the TestNG tests within your IDE.

For example, if your package name is com.appium.example, your main activity name is .Activities.MainActivity, and the absolute filepath to your APK is ~/Desktop/appium/app.apk, you would run the following command.

um --pre-launch --app-pkg com.appium.example --app-activity .Activities.MainActivity --platform-name Android --app ~/Desktop/appium/app.apk

Running Your Tests on AWS Device Farm

Step 1: Verify the Project Set-up

First Read the Device Farm documentation. Ensure that all the steps are completed and that your project and POM file are set up correctly.

Step 2: Go into your Maven Appium Directory

Go into your Appium Maven project directory in the terminal or command prompt.

Step 3: Package the Test Content

Run the following Maven command to package the test content.

clean package -DskipTests=true

Step 4: Locate the zip-with-dependencies.zip file

Once the Maven command above is finished it will produce a “zip-with-dependencies.zip” file in your target folder. You will upload this file when creating a run on AWS Device Farm.

Examples For Android

Examples for Testing Specific Scenarios

Hybrid Web Views (Not implemented)
Web View

Strategies for Native Features

Examples for Testing Inputs

Examples for Automated Navigation

Tips and Tricks

Driver Configuration

Remember to set up your Appium driver correctly. AWS Device Farm takes care of the configuration for you, and you don't need to set any of the DesiredCapabilities when creating the driver. Refer to this example.

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.