Get Started with Xamarin.Android in 10 Minutes

Visual Studio for Mac

On Windows? Try the Visual Studio 2017 walkthrough.


Visual Studio for Mac and Xamarin enables you to get a fully native cross-platform app running live on your Android device.

In this getting started series you will:

  • Set up your development environment for Xamarin.
  • Learn how to install the Xamarin Live Player on your Android device.
  • Learn how to use the Xamarin Live Player.

Install Visual Studio for Mac

In order to complete this walkthrough, Visual Studio for Mac must be installed on your machine. Make sure you have:

  1. A Mac with OS X 10.11, macOS 10.12, or greater.
  2. The latest stable version of Visual Studio for Mac installed.

The next step is to get the Xamarin Live Player app installed on your Android device. By pairing your device to the IDE you can continuously deploy, test, and debug your app directly on the device.

Get Started

Now that you have the tools installed, it's time to starting playing with Xamarin.Android and the Xamarin Live Player. The next page guides you through installing the Xamarin Live Player app on your Android device, show you how to deploy and debug an app on the device, and have you edit code and watch the changes appear in real time—all in less than 10 minutes. To get started, click Next.

Next >


Alternatively, if you would like to start developing a two-page Android application from scratch, visit the long-form Hello, Android and Hello, Android Multiscreen series. These tutorials will introduce the tools, concepts, and steps required to build and deploy a Xamarin.Android app.

Get Started with Xamarin.Android in 10 Minutes

Visual Studio 2017

On Mac? Try the Visual Studio for Mac walkthrough.


Visual Studio 2017 and Xamarin enables you to get a fully native cross-platform app running live on your device.

In this getting started series you will:

  • Set up your development environment for Xamarin.
  • Learn how to install the Xamarin Live Player on your Android device.
  • Learn how to use the Xamarin Live Player.

Install Visual Studio and Xamarin

In order to complete this walkthrough, Visual Studio 2017 and Xamarin must be installed on your machine. Make sure you have:

  1. A Windows 7 machine or higher.
  2. Visual Studio 2017 version 15.4 or higher with the Mobile development with .NET workload installed.
    • If you don’t have Visual Studio installed, go to https://www.visualstudio.com/vs/ to download it.
    • To install the Xamarin tools, follow the steps in the Installation guide.
    • If you have previously installed Visual Studio 2017, you can check that you're on the latest version by following the steps described in the Updater guide.

The next step is to get the Xamarin Live Player app installed on your Android device. By pairing your device to the IDE, you can continuously deploy, test, and debug your app directly on the device.

Get Started

Now that you have the tools installed, it's time to starting playing with Xamarin.Android and the Xamarin Live Player. The next page guides you through installing the Xamarin Live Player app on your Android device, show you how to deploy and debug an app on the device, and have you edit code and watch the changes appear in real time—all in less than 10 minutes. To get started, click Next.

Next >


Alternatively, if you would like to start developing a two-page Android application from scratch, visit the long-form Hello, Android and Hello, Android Multiscreen series. These tutorials will introduce the tools, concepts, and steps required to build and deploy a Xamarin.Android app.