Installing Xamarin in Visual Studio 2017

Check the system requirements before you begin.

Installation

Xamarin can be installed as part of a new Visual Studio 2017 installation, with the following steps:

  1. Download Visual Studio 2017 Community, Visual Studio Professional, or Visual Studio Enterprise from the Visual Studio page (download links are provided at the bottom).

  2. Double-click the downloaded package to start installation.

  3. Select the Mobile development with .NET workload from the installation screen:

    Mobile development with .NET selection on the Workloads screen

  4. While Mobile development with .NET is selected, have a look at the Installation details panel on the right. Here, you can deselect mobile development options that you do not want to install.

    Installation details panel, listing Xamarin options to install

  5. When you are ready to begin Visual Studio 2017 installation, click the Install button in the lower right-hand corner:

    Install button

    Depending on which edition of Visual Studio 2017 you are installing, the installation process can take a long time to complete. You can use the progress bars to monitor the installation:

    Progress bars during installation

  6. When Visual Studio 2017 installation has completed, click the Launch button to start Visual Studio:

    Location of Launch button

Adding Xamarin to Visual Studio 2017

If Visual Studio 2017 is already installed, add Xamarin by re-running the Visual Studio 2017 installer to modify workloads (see Modify Visual Studio for details). Next, follow the steps listed above to install Xamarin.

For more information about downloading and installing Visual Studio 2017, see Install Visual Studio 2017.

In Visual Studio 2017, verify that Xamarin is installed by clicking the Help menu. If Xamarin is installed, you should see a Xamarin menu item as shown in this screenshot:

Xamarin menu item on the Help menu

You can also click Help > About Microsoft Visual Studio and scroll through the list of installed products to see if Xamarin is installed:

Visual Studio 2015 installed products screen

For more information about locating version information, see Where can I find my version information and logs?

Next steps

Installing Xamarin in Visual Studio 2017 allows you to start writing code for your apps, but does require additional setup for building and deploying your apps to simulator, emulator, and device. Visit the following guides to complete your installation and start building cross platform apps.

iOS

For more detailed information, see the Installing Xamarin.iOS on Windows guide.

  1. Install Visual Studio for Mac
  2. Connect Visual Studio to your Mac build host
  3. iOS Developer Setup - Required to run your application on device
  4. Remoted iOS Simulator
  5. Introduction to Xamarin.iOS for Visual Studio

Android

For more detailed information, see the Installing Xamarin.Android on Windows guide.

  1. Xamarin.Android Configuration
  2. Using the Xamarin Android SDK Manager
  3. Android SDK Emulator
  4. Set Up Device for Development