Setup and Installation

PDF for offline use
Sample Code:

Let us know how you feel about this

Translation Quality


last updated: 2017-12

This article walks through the installation steps and configuration details required to prepare your computer and devices for Android Wear development. By the end of this article, you'll have a working Xamarin.Android Wear installation integrated into Visual Studio for Mac and/or Microsoft Visual Studio, and you'll be ready to start building your first Xamarin.Android Wear application.


The following is required to create Xamarin-based Android Wear apps:

  • Visual Studio or Visual Studio for Mac – You If you are using Visual Studio, Visual Studio 2015 Professional or later is required.

  • Xamarin.Android – Xamarin.Android 4.17 or later must be installed and configured with either Visual Studio or Visual Studio for Mac.

  • Android SDK - Android SDK 5.0.1 (API 21) or later must be installed via the Android SDK Manager.

  • Java Developer Kit – Xamarin Android development requires JDK 1.8 or later if you are developing for API level 24 or greater (JDK 1.8 also supports API levels earlier than 24).

You can continue to use JDK 1.7 if you are developing specifically for API level 23 or earlier.


After you have installed Xamarin.Android, perform the following steps so that you're ready to build and test Android Wear apps:

  1. Install the required Android SDK and tools.
  2. Configure a test device.
  3. Create your first Android Wear app.

These steps are described in the following sections.

Install Android SDK and tools

Launch the Android SDK Manager:

How to launch the Android SDK Manager in Visual Studio

How to launch the Android SDK Manager in Visual Studio for Mac

Ensure that you have the following Android SDK and tools installed:

  • Android SDK Tools v 24.0.0 or higher, and
  • Android 4.4W (API20), or
  • Android 5.0.1 (API21) or higher.

If you do not have the latest SDK and tools installed, download the required SDK tools and the API bits (you may need to scroll a bit to find them – the API selection is shown below):

Example SDK Manager screenshot of enabling Android 5.0.1 components

Example SDK Manager screenshot of enabling Android 4.4 and 5.0.1 components


Before you can use test your app, you must configure an Android Wear emulator or an actual Android Wear device.

Android Wear Emulator

Before you can use an Android Wear emulator, you must configure an Android Wear Android Virtual Device (AVD) using the Google Emulator Manager:

How to launch the Android Emulator Manager from Visual Studio

How to launch the Android Emulator Manager from Visual Studio for Mac

For more information about setting up an Android Wear emulator, see Debug Android Wear on an Emulator.

Android Wear Device

If you have an Android Wear device such as an Android Wear Smartwatch, You can debug the app on this device instead of using an emulator. For information about developing with a Wear device, see Debug on a Wear Device.

Create Your First Android Wear App

Follow the Hello, Wear instructions to build your first watch app.

Packaging Your App

Android wear applications are always distributed with a companion Android phone app.

When you add your Android Wear application as a reference to your main Android application it is automatically assumed to be an Android Wear project and will generate all necessary XML and metadata for you. In addition, it will verify that package and version numbers match so you can easily ship your apps to Google Play.

To learn more about packaging Wear apps, see Working with Packaging.

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.