Installing Xamarin.Android on Windows

PDF for offline use:
Related Articles:
Related SDKs:

Let us know how you feel about this.

Thanks for the feedback!

This article walks through the installation steps and configuration details required to install Xamarin.Android. By the end of this article, we will have a working Xamarin.Android installation integrated into Xamarin Studio and/or Microsoft Visual Studio, and we’ll be ready to start building our first Xamarin.Android application.


The Xamarin.Android installer will automatically detect, download, and install any components required for completing the installation. This tutorial examines the installation and configuration steps required to install the Xamarin platform and to get our development environment set up, including how to:

Download the Xamarin Unified Installer

The first step is to download the Xamarin unified installer, which can be found at

Depending on if you select the I already have Visual Studio Installed checkbox, you will be offered the option of downloading either Visual Studio Community Edition (if you don't have Visual Studio installed), or Xamarin for Visual Studio, via the Xamarin Unified Installer.

Regardless of which package you download, you can follow the instruction below.

Run the Xamarin Installer

Visual Studio Community installer

Open the installer to begin the installation process:

The installer will assess your system, and allow you select optional components. Make sure to select Xamarin from the menu when prompted.

Xamarin Unified Installer

Open the installer to begin the installation process:

Step 1 – Xamarin License

The first step in the installation requires you to review and accept the license in order to proceed. To do this, click the checkbox and press Next:

Step 2 – Identify the Required Components

Next, the installer will inspect the system to determine which, if any, required components are missing and need to be downloaded and installed. You can select which products you wish to download here:

Step 3 – Install the Components

After identifying missing components, the Xamarin installer will download and execute the installers for the platform dependencies, as shown in the screenshots below.

The Xamarin unified installer will start the download and install process of the selected items:

When the installation is complete, close this window to exit the installer and begin working with Xamarin.

Configure the Installation

Now that we’ve installed the components, we might need to tell our IDE where to find them. Visual Studio both has configuration options that let us specify the Java and Android SDK locations.

During installation, the installer places the components in their default locations and configures the development environment with the appropriate path configuration. For most users the default locations will work without further changes in these screens.

However, if they're already installed or if they are in locations other than the default, then the the following screens should be used to specify the paths to these components.

To configure the Visual Studio tools, navigate to Tools > Options > Xamarin > Android Settings:


NoteThis is only applicable if you have a valid Xamarin license and you want to continue to use it. If you have a Professional or Enterprise MSDN subscription, ensure that you have logged in to Visual Studio. Logging in with your MSDN subscription will allow you access to the full suite of Xamarin Products. Alternatively, you can also take advantage of the Visual Studio Community Edition, which will allow you to develop with Xamarin for free.

If you've already purchased your Xamarin products, browse to Tools > Xamarin Account… and log in with your Xamarin credentials:

Upon successful activation the IDE will notify you that the activation has been completed, and how many machines are left on your subscription:

Create an Application

Now that we’ve installed the components, we can launch our IDE of choice and create a new solution.

For example, to create a new application in Visual Studio we would choose New Project... from the Visual Studio Welcome Screen and select Android > Android Application in the New Solution dialog. Choose an application name and click OK:

That’s it! Now we’re all set up to use Xamarin.Android to create Android applications!


In this article we examined how to set up and install the Xamarin.Android platform on Windows. We also looked at some different ways to configure our platform installation in Visual Studio.

In the next tutorial, we’ll use Xamarin.Android to create our first Android application.

You might also want to download and install the Xamarin Android Player so that you can test your Android apps.