openstf / stf-appium-example

Run Appium test on OpenSTF Device

STF Appium Example

In this tutorial, I am going to explain how to integrate Appium automated test to OpenSTF device using its REST API. Theoretically, it is possible to run automated test of any tool on OpenSTF device. The reason for choosing Appium here is because it is one of the most widely used mobile automated testing tool.

Prerequisites

• Your device farm is ready and you are using v2.0 or above.
• You have read OpenSTF API Doc.
• You know about Appium and its usages.

Dependencies

• NodeJS
• Ruby > v2.2

Installation

1. Git clone

git clone [e-mail]:openstf/stf-appium-example.git

2. Install appium & other node dependencies

npm install

Note You will also need to install all the Appium Dependencies for Android

3. Install ruby dependencies

bundle install --path=bundler/vendor

## In case bundler is not installed, installed it using below command
gem install bundler

Running example tests

1. Update SWAGGER_URL in stf_connect.js & stf_disconnect.js with your domain.
2. Create a new Access Token from Settings > Keys > Access Tokens and update stf_connect.js & stf_disconnect.js
3. Run below command

DEVICE_SERIAL=YOUR_DEVICE_SERIAL ./scripts/run_integration_test.sh

4. Sample test result