Paragon - Test automation framework for mobile & apis.

Paragon is a webdriverIO Cucumber based test automation framework for mobile apps that provides a standard mechanism for the configuration & running of test suites.

![alt text] ()

Requirements

In order to get started, you'll need to install:

• Node.js (see user guide - )
• XCode (see user guide - )
• Android Studio (see user guide - )
• Gulp - on your command line execute npm i -g gulp
• Appium - on your command line execute npm i -g appium
• Appium Doctor - on your command line execute npm i -g appium-doctor

Note: In case of permission denied error, please try with sudo or else fix ownership of usr/lib/local drive by typing following command: sudo chown -R $USER /usr/local/lib

Setup envoirnment variable

Open you Terminal and type open -e ~/.bash_profile . if file not availble, create one using touch ~/.bash_profile

Edit your bash profile file with following envoirnment variables enteries (please ensure details are specific to your machine)

• export ANDROID_HOME="/Users//Library/Android/sdk"
• export JAVA_HOME="/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home"
• Append to your PATH variable with ${ANDROID_HOME}/emulator:${ANDROID_HOME}/tools:$ANDROID_HOME/platform-tools:${ANDROID_HOME}/build-tools/29.0.0-rc2:${JAVA_HOME}/bin

Close the terminal and restart terminal again, verify your env path by typing following commands

• echo $JAVA_HOME
• echo $ANDROID_HOME

These commands should return path to corresponding sdks

appium-doctor verification

Open your terminal and run command appium-doctor.

• please ensure all necessary dependencies are ticked marked and fix any crosses dependencies.

Now you're ready to get started!

Getting Started

To get started with Paragon in your project, first ensure you have installed the requirements above, then open a command line and navigate to your projects directory.

Once you are in your projects directory, clone paragon from git repository:

git clone https://tfsweb.intranet.bbl/tfs/BBLCollection/Modern-App/_git/testautomation

Now you need to install all dependencies required for the project. You can do this by executing following command:

npm install

Command line

you are now ready to run your first test. type following command:

for iOS gulp test:ios --ff "<featureFile name>" --args "<tags>"

for Android gulp test:android --ff "<featureFile name>" --args "<tags>"

Configuration

All of the configuration for paragon is contained within the <android/ios>.conf.js file, see the options below for more information regarding configuration:

• Test Configuration
• User guide