cordova-test

cli-tool to automate Appium tests suite for Cordova apps

#Install

npm install -g cordova-test

#Usage Inside your cordova application folder

cordova-test <platform> <relative_path_to_tests_dir_or_file> 
  [--no-compile]
  [--babel use babel transpiler]
  [--teamcity use mocha-teamcity-reporter] 
  [--device iOS build for device/emulator]
  [--env environment files_regex]
  [--sauce user accessKey]
  [--udid ios_udid]
  [--device-name device name]
  [--platform-version platform version]

#Environment As default cordova-test will run the tests with mocha, but it can also be integrated to run with any other environment you want by setting the --env param.

For ex.:

$ cordova-test android tests/tape --env tape *.js
$ cordova-test android tests/python --env python *.py

#Example As an example we create a simple Hello World app with cordova,

cordova create example com.urucas.testexample TestExample
cordova platform add android

and add a few elements to the index.html

Now, we create 2 appium tests to run with mocha, the first one will check that some elements on the index.html are displayed, and the second test will click on a button and check a text is changed.

Inside our cordova project root folder run cordova-test android tests/mocha and wait for the tests result.

Thats all!

cordova-test will compile the cordova app, verify the requested environment, create the test capabilities and run all the tests.

#Integrate with Sauce Labs Set your Sauce Labs user and access key to run the tests suite in Sauce Labs mobile devices.

For ex.

$ cordova-test android tests/mocha --sauce SAUCE_USER SAUCE_ACCESSKEY

Before running the tests, cordova-test will upload the compiled app to Sauce Labs Storage, and update the platform capabilities.

#Requirements

• cordova

Local testing

• appium

iOS

• xcode command-line tools

Babel

• To use the babel transpiler and es2015 in your tests you need to install these dependencies in your Cordova project:

npm i --save-dev babel-core babel-plugin-transform-async-to-generator babel-polyfill babel-preset-es2015

• .babel.rc config:

{
 "presets": ["react", "es2015"],
 "plugins": ["transform-async-to-generator"]
}

Team City

• Use the --teamcity flag to activate the mocha-teamcity-reporter. Install the dependency in the target project before using the flag:

npm i mocha-teamcity-reporter --save-dev