Visual Studio 2017 for Mac

Developer Community | System Requirements | Compatibility | Distributable Code | Xamarin | Blogs | Servicing


If you are accessing this page from a non-English language version, and want to see the most up-to-date content, please visit this Release Notes page in English.


You can switch the page language at the bottom of this page. Click the globe icon, search for your language, or select from the list of available languages.

This article contains information about the newest release of Visual Studio 2017 for Mac, version 7.2.

Use Visual Studio 2017 for Mac to build apps for mobile, web, and the cloud with Xamarin and .NET Core, as well as games with Unity.

Download Visual Studio 2017 for Mac

To learn more about Visual Studio 2017 for Mac, see Mac System Requirements and Mac Platform Targeting and Compatibility.

To learn more about other related downloads, see the Downloads page.


We’d love to hear from you! You can report a problem via the Report a Problem option in the upper right hand corner of the Visual Studio for Mac IDE itself. You can track your feedback in the Developer Community portal. For suggestions, let us know through UserVoice.

Release Date: November 8, 2017 - Visual Studio 2017 for Mac

This release includes support for Xcode 9.1.

Release Date: October 30, 2017 - Visual Studio 2017 for Mac

The following issues were fixed in this release:

  • UI hang on opening TypeScript file
  • Fixed an issue that would prevent users from registering Google Play Api keys needed to publish to Play Store.
  • Fixed an issue where the IDE could crash if objective-c code throws an exception.

Release Date: October 9, 2017 - Visual Studio 2017 for Mac

Visual Studio for Mac 7.2 primarily focuses on bug fixes and performance improvements and includes the following features.

.NET Core

  • .NET Core 2 is now included by default during installation


  • On-demand SDK installer. Android SDKs that are not installed can be installed in the background.
  • Android 8.0 Oreo is now supported.


  • Xcode 9 is supported in this release.

Docker Support

You can now publish ASP.NET Core apps to Docker containers and run them from an App Service.

To enable Docker support to your project, right click on your ASP.NET Core web app and Add > Add Docker Support.

To publish your web app to a Docker container, use the Publish > Publish to Azure workflow introduced in Visual Studio for Mac (right click on the web app project in the Solution Pad).

During publishing the following resources are created on Azure:

  • A container registry.
  • A new Docker image is created, tagged, and pushed to this Azure container registry.
  • Azure storage, for the container registry.
  • An App Service.
    • This downloads the image from the container registry and runs it.
mac docker publish
(Figure 1) Docker Publishing


  • If you use an existing Resource Group, it must be in the same region as the App Service Plan you are creating.
  • If you are creating a new Resource Group, you must set the Container Registry and the App Service plan to be in the same region (e.g. both must be in “West US”).
  • The VM size of the App Service Plan must be S1 or larger.

Xamarin Live Player (Preview)

Xamarin Live Player enables developers to continuously deploy and debug their app, straight to an iOS or Android device.

For more information visit

Note that Live Player integration is currently disabled. It can be enabled in Preferences | Project | Xamarin Live Player (Preview) by toggling "Enable Xamarin Live Player".


  • IoT and Azure Functions are currently in preview and are available as additional Extensions available via the Extension Manager. They are not installed by default with Visual Studio for Mac.

Top Issues Fixed in this Release

Known Issues

  • Azure Functions: Debugging Azure Functions does not work when the project is first created. Close and reopen the project to be able to debug.
  • Docker can interfere with launching Android emulators that use HAXM. When debugging Android apps on emulators, please shutdown Docker before attempting to debug.

Visual Studio 2017 for Mac Release Notes History

Current Release Notes

Visual Studio 2017 for Mac version 7.4 Release Notes

Visual Studio 2017 for Mac version 7.3 Release Notes

Visual Studio 2017 for Mac version 7.2 Release Notes

Visual Studio 2017 for Mac version 7.1 Release Notes

Visual Studio 2017 for Mac version 7.0 Release Notes

Top of Page