Installing Xamarin.Android on Windows

PDF for offline use
Related Articles:
Related SDKs:

Let us know how you feel about this

Translation Quality


last updated: 2017-03

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

Download Visual Studio

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:

Installation process screen

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:

Xamarin Installer

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:

Xamarin License agreement

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.

Xamarin Installer requirements

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

Installing software

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:

Visual Studio Android Settings



Note: This 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... to display the account dialog:

Xamarin account login screen

Log in with your Xamarin credentials:

Enter login name and password

Upon successful activation the IDE will notify you that the activation has been completed:

License has been activated

You can then return to the Xamarin Account dialog screen, which will indicate that your Xamarin Account has been successfully linked to the Xamarin for Visual Studio:

Xamarin account is linked to Visual Studio

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:

New Project dialog

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 your first Android application.

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

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.