Visual Studio App Center Test is the next generation of Xamarin Test Cloud! Read the blog post.

Working with Calabash

PDF for offline use

Let us know how you feel about this

Translation Quality


last updated: 2016-09

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.


Please note that Calabash is no longer under active development.


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.

iOS 10

This guide explains how to update Calabash to test on iOS 10, and covers some prerequisites and differences between testing on previous versions of iOS.

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

Testing on physical devices is an important part of creating a mobile application. Calabash allows developers to create automated tests for mobile applications and Xamarin Test Cloud provides a service that will run these tests on hundreds of physical devices. This guide will discuss how to submit 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.

Testing with Xcode 8 and iOS 8

This article discusses using Xcode 7

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.