Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
64 lines (39 sloc) 2.314 kb



You need to have Ruby installed. Verify your installation by running ruby -v in a terminal - it should print "ruby 1.8.7" (or higher).

If you are on Windows you can get Ruby from

You should have the Android SDK installed. You can download it from here. Create an environment variable with the name : ANDROID_HOME and its value pointing to the location of the unzipped downloaded SDK.

You also need to have Ant installed and added to your path. It can be downloaded from here.


Install calabash-android by running

  • gem install calabash-android
  • You might have to run sudo gem install calabash-android if you do not have the right permissions.

Troubleshooting Installation


If you are on Mac you may see an error like this:

~$ sudo gem install calabash-android
Building native extensions.  This could take a while...
ERROR:  Error installing calabash-android:

ERROR: Failed to build gem native extension.

/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/bin/ruby extconf.rb
mkmf.rb can't find header files for ruby at /System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/lib/ruby/ruby.h

One possible cause can be not having the correct Command Line Tools (compiler tool chain) for your OS X release. For example, for OS X 10.8 "Mountain Lion" you need the "Mountain Lion" version of these. If you have Xcode installed you can install them from it's Preferences pane (in the Download tab). Otherwise you can download the Command Line Tools for you OS X version from the Apple Developer web site.


These instructions assume you'll be using Ruby 1.9.1.

Installing Ruby:

sudo apt-get install ruby1.9.1

You might need to install the dev package when installing calabash:

sudo apt-get install ruby1.9.1-dev

If you see something like this while installing calabash:

cannot load such file -- rspec/expectations (LoadError)

It's because the rspec package isn't installed:

gem install rspec
Jump to Line
Something went wrong with that request. Please try again.