Calabash-Android

Calabash-Android lets you run Cucumber features on your Android device or emulator.

Feature: Login feature
  Scenario: As a valid user I can log into my app
    Given I am a valid user
    And I enter my username
    And I enter my password
    And I press "Login"
    Then I see "Welcome to coolest app ever"

You can run your Calabash features on multiple devices using LessPainful.com.

Installation

Prerequisites

You need to have cucumber, Ruby 1.9.2+ installed, and a recent RubyGems installation.

You can install cucumber like this:

gem install cucumber

The json gem is also required

gem install json

You should have the Android SDK installed and the environment variable ANDROID_HOME should be pointing to it.

Finally, you need the git tool to obtain the source.

• Installing git on windows

• Installing git on Linux (you only need the first step: First: Download and Install Git).

• Installing git on MacOS

Installation

You can obtain the newest version of Calabash-Android by cloning it using the following command

git clone git://github.com/calabash/calabash-android.git

Change directory to into the cloned directory: calabash-android. Fetch calabash-js which is a shared project with calabash-ios:

git submodule init
git submodule update

Configuration

Change the following value in the build.properties file:

• tested.package_name the package name from your AndroidManifest.xml.
• tested.main_activity the fully qualified name of your main activity.
• tested.project.apk path to the APK you want to test.

Notice: Make sure that the app you are trying to test is signed with the key.store certificate.

Writing a test

The Cucumber features goes in the features library and should have the ".feature" extension.

You can start out by looking at features/test_dummy.feature. You can extend this feature or make your own using some of the predefined steps that comes with Calabash.

Running test

To run your test:

ant test

To specify on which device the test should run (if you have both an emulator running and a device attached), pass the adb.device.arg system property (-e or -d) like so:

ant test -Dadb.device.arg=-e

Predefined steps

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