Setup and Install Visual Studio for Mac
To start developing native, cross-platform apps when you download Visual Studio for Mac there are a couple of things that you must install and set up in preparation.
For working with iOS in Visual Studio you need the following pieces:
- a Mac with macOS Sierra 10.12 or above
- Xcode 8.3 or above. The latest stable version is usually recommended.
- An Apple ID. If you don't have an Apple ID already you can create a new one at https://appleid.apple.com. It's necessary to have an Apple ID for installing and signing into Xcode.
Download Visual Studio for Mac from https://visualstudio.microsoft.com/
Once the installer package is downloaded, click the VisualStudioInstaller.dmg file to mount the installer and then run it by double-clicking the logo, as illustrated by the following image:
You might be prompted with an alert dialog similar to the following image. In this case, click Open:
The installer inspects your system to verify which components need to be installed or updated:
You'll then be presented with an alert dialog asking you to acknowledge the Privacy and License terms. Press the Continue button to acknowledge the terms:
The installer presents a list of required components that are missing and that need to be downloaded and installed. Select the products you wish to download here:
If you do not wish to install all platforms, use the guide below to help you decide which platforms to install:
- Apps using Xamarin:
- Xamarin.Forms – Select Android and iOS platforms.
- iOS only – Select iOS platform (Note that you will need to install Xcode).
- Android only – Select Android platform (Note that you should also select the relevant dependencies).
- Mac only – Select macOS platform (Note that you will need to install Xcode).
- Fully cross-platform Xamarin apps – Select Android, iOS, and macOS platforms.
- .NET Core applications – Select .NET Core platform.
- ASP.NET Core Web Applications – Select .NET Core platform.
- Cross-platform Unity Game Development – No additional platforms need to be installed beyond Visual Studio for Mac. Refer to the Unity setup guide for more information on installing the Unity extension.
This installation screen displays the version and size of each individual component. You can click each component to display a list of dependencies for that component (for Android), see additional packages that it downloads (for .NET Core), or view any additional applications required (for iOS and macOS):
- Apps using Xamarin:
Once you are happy with your selection, select the Install and Update button to start the installation process.
The installer starts the download and install process of the selected items:
You might be prompted to elevate the permissions necessary for individual components that are needed to complete installation. Enter your administrator credentials here to continue the installation process:
Once the installation is successful, you can start developing apps in Visual Studio by pressing Start:
If you chose not install a platform or tool during the original installation (by unselecting it in step #6), you must run the installer again if you wish to add the components later.
Install Visual Studio for Mac behind a firewall or proxy server
To install Visual Studio for Mac behind a firewall, certain endpoints must be made accessible in order to allow downloads of the required tools and updates for your software.
Configure your network to allow access to the following locations:
Installing Visual Studio for Mac allows you to start writing code for your apps. The following guides are provided to guide you through the next steps of writing and deploying your projects.
.NET Core apps, ASP.NET Core web apps, Unity game development
For other Workloads, refer to the Workloads page.