Installing Xamarin in Visual Studio on Windows
- PDF for offline use
Let us know how you feel about this
last updated: 2017-09
Because Xamarin is now included with all editions of Visual Studio at no extra cost and does not require a separate license, you can use the Visual Studio installer to download and install Xamarin tools.
- Adding Xamarin to Visual Studio 2017
- Adding Xamarin to Visual Studio 2015
- Verifying Installation
- Next Steps
The following are required for installing Visual Studio tools for Xamarin:
Windows 7 or higher.
Visual Studio 2015 or 2017 (Community, Professional, or Enterprise).
Xamarin for Visual Studio.
Note that Xamarin cannot be used with Express editions of Visual Studio due to lack of plug-in support.
For more information about the pre-requisites for installing and using Xamarin, see System Requirements.
Xamarin can be installed as part of a new Visual Studio installation. To achieve this, use the following steps:
Download Visual Studio Community, Visual Studio Professional, or Visual Studio Enterprise from the Visual Studio page (download links are provided at the bottom).
Double-click the downloaded package to start installation.
Select the Mobile development with .NET workload from the installation screen:
While Mobile development with .NET is selected, have a look at the Summary panel on the right. Here, you can deselect mobile development options that you do not want to install. By default, all options shown in the following screenshot are installed (Xamarin Workbooks, Xamarin Profiler, Xamarin Remoted Simulator, Android NDK, Android SDK, Java SE Development Kit, Google Android Emulator, F# support, and Intel HAXM):
When you are ready to begin Visual Studio installation, click the Install button in the lower right-hand corner:
Depending on which edition of Visual Studio you are installing, the installation process can take a long time to complete. You can use the progress bars to monitor the installation:
When Visual Studio installation has completed, click the Launch button to start Visual Studio:
Adding Xamarin to Visual Studio 2017
If Visual Studio 2017 is already installed, you can add Xamarin by re-rerunning the Visual Studio 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.
Adding Xamarin to Visual Studio 2015
To add Xamarin.Android to an existing installation of Visual Studio 2015, use the following steps:
Right-click the Windows Start button and select Programs and Features.
Right-click Microsoft Visual Studio and click Change.
When the Visual Studio Installer dialog appears, click the Modify button.
In the Features tab, scroll down to Cross Platform Mobile Development. Click the checkbox next to C#/.NET (Xamarin):
Click the UPDATE button to add Xamarin to Visual Studio.
In Visual Studio 2017, you can 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:
If you are using an earlier versions of Visual Studio, you can click Help > About Microsoft Visual Studio and scroll through the list of installed products to see if Xamarin is installed:
For more information about locating version information, see Where can I find my version information and logs?
Installing Visual Studio Tools for Xamarin 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.
For more detailed information, see the Installing Xamarin.iOS on Windows guide.
- Install Xamarin.iOS tools on your Mac
- Configuring your Mac
- iOS Developer Setup (To run your application on device).
- Connecting Visual Studio to your Mac build host
- Remoted iOS Simulator
- Introduction to Xamarin.iOS for Visual Studio
For more detailed information, see the Installing Xamarin.Android on Windows guide.