Welcome to Calabash for Perfecto Mobile

Calabash is an automated testing technology for Android and iOS native applications; it is a free open source project.

Calabash for Perfecto Mobile enables testing on real devices from anywhere in your organization, within the Perfecto Mobile Continuous Quality Lab. This includes a large scale of devices located in various geographies, and capabilities such as device logs, device vitals, video, detailed reports and more.

Documentation

The documentation is split into the following sections:

• Installation
• Predefined Steps
• Environment variables

Supported mobile platforms

Android 4.2 and higher
iOS 7 and higher

Supported Platforms

• Windows 7
• Macintosh OS X v10.9.5

Create a Cucumber skeleton

Copy the features-skeleton directory located in <RUBY_HOME directory>\lib\ruby\gems\<rubyVersion>\gems\calabash-perfectomobile-<version> (also here), into any folder, and rename it to features. It is recommended to save your app in this directory, this will enable you to specify only the app name (without the full path) in your calabash-perfectomobile test execution.

The Cucumber skeleton looks like this:

features
|_support
| |_app_installation_hooks.rb
| |_app_life_cycle_hooks.rb
| |_env.rb
| |_hooks.rb
|_step_definitions
| |_calabash_steps.rb
|_my_first.feature

In this skeleton you find a reference to all the predefined steps that come with calabash-perfectomobile, and the my_first.feature file.

Write a test

The Cucumber features go into the features library and should have the ".feature" extension.

You can start out by looking at features/my_first.feature. You can extend this feature or write your own using the predefined steps that come with calabash-perfectomobile.

Configure environment parameters

There are 3 ways to configure the calabash-perfectomobile parameters:

1. Command line arguments
   • To use, run
     calabash-perfectomobile [options] apk-file/ipa-file
     For example: calabash-perfectomobile -i -a 'myAppName' -c 'mobilecloud.perfectomobile.com' -u 'myUsername' -p 'myPassword' -d 'myDeviceId' 'myApp.ipa' -r features\Reports
   • For more command options, run
     calabash-perfectomobile -h
2. Environment variables
   • Add to your environment variables:
     click here for more details on the environment variables.
     CALABASH_PERFECTO_MOBILE_APP_FILE
CALABASH_PERFECTO_MOBILE_APP_NAME
CALABASH_PERFECTO_MOBILE_INSTALL
CALABASH_PERFECTO_MOBILE_MOBILECLOUD
CALABASH_PERFECTO_MOBILE_USER
CALABASH_PERFECTO_MOBILE_PASSWORD
CALABASH_PERFECTO_MOBILE_DEVICE
CALABASH_PERFECTO_MOBILE_REPORT_DIR
CALABASH_PERFECTO_MOBILE_UPLOAD_LOCATION
     
3. env.rb
   • Update the env.rb file, located in features\support

Run test

To run your test, cd to the current working directory that contains your features directory, and run the command:

calabash-perfectomobile [options] apk-file/ipa-file

For more command options, run calabash-perfectomobile -h

Note: calabash-perfectomobile will install the application as non-instrumented.

Report location

Perfecto Mobile reports are placed in the current working directory by default. The location can be changed with the command line argument -r, or by setting the SCREENSHOT_PATH environment variable, or by modifying the $PMReportDir in the env.rb file.

Predefined steps

The predefined steps are located in the features/step_definitions directory. A compiled list of predefined steps with comments is available here