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

Running Tests on Android

PDF for offline use

Let us know how you feel about this

Translation Quality


last updated: 2016-12

If you have an Android device connected to your computer and it is properly configured, then Xamarin.UITest will attempt to deploy the application to the device and run the tests on it.

There are two ways to run tests on a local device:

  1. Through the IDE – Both Visual Studio for Mac and Visual Studio can submit the test run to Test Cloud.
  2. Programmatically Declaring the Device – Using the UITest API, a test can explicitly identify a device that it should be run on.

Each of these topics will be discussed in more detail below.


The Android device must be unlocked before Visual Studio for Mac can run the tests on the device.

Running Tests with the IDE

First set the Android project to be the startup project for the solution.

Next, open the Unit Test pad in Visual Studio for Mac by selecting View > Pads > Unit Tests. The tree view has a node called Test Apps:

Expand the test project in the Unit Tests pad, and select Run Test for the UITest project:

Once the tests have run, you can see the results in the Unit Tests pad and the Test Results pad:

Before trying to run the tests, ensure that you have build the APK or the IPA.

To run test on a local device, open the Test Explorer by selecting Test > Windows > Test Explorer.

Next, ensure that your Android device is connected to your computer, and then change the build target to Release and select the device that you want to run the tests on:

Selecting the device and configuring a Release build in Visual Studio

From here, you can run the unit tests from the Test Explorer.

Programmatically Declaring the Device

If there is only one device attached to the computer, and no running simulators, then UITest will automatically run the tests on the device.

If you have more than one device connected or an emulator running, then you must provide the serial identifier of the device that UITest should run the tests on. You can obtain a list of the devices and emulators using the Android Debug Bridge, as shown in the following snippet:

$ adb devices
List of devices attached
0756edf000620ace    device

The following snippet shows how to set the serial id for the IApp instance used in the test:

IApp app = ConfigureApp.Android

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.