Xamarin Test Cloud is now part of Visual Studio App Center! Get Started.

Working with Calabash

PDF for offline use

Let us know how you feel about this

Translation Quality


How to accomplish common tasks with Calabash

Section Overview

The documents in this section discuss various task for writing Calabash and submitting them to Test Cloud.


Backdoors are methods that can be invoked during a test run to perform some special action to configure or set up testing state on a device. For example, a backdoor may be used to seed a database with some test data so that all of the tests in a given fixture have the same data.

Entering Text

Describes how to enter text into Views on the screen.


Simulate gestures such as taps and swipes in your Calabash tests.

Identifying iOS Devices and Simulators

This guide discusses how you many identify the various iOS devices connected to your workstation and the different iOS simulators available for running Calabash tests.

Running Calabash Tests on Local Devices

This guide will discuss how to run Calabash tests on local devices attached to your computer.

Submitting Calabash Tests to Xamarin Test Cloud

This guide describes how to submit your Calabash tests to Xamarin Test Cloud.

Testing on Local Devices

This guide will discuss how to run your Calabash tests on devices connected to your computer.

Timeouts & Waiting

This guide will discuss how to use timeouts and waits in Calabash.

Web Views

Describes how to use the Calabash APIs to interact with web views in a mobile app.

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.