Visual Studio Icon Visual Studio 2017 for Mac Preview Release Notes

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


Install the most recent Preview version of Visual Studio for Mac by changing the updater channel to Beta.


This release is not "go-live" and not intended for use on production computers or for creating production code.

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 would love to hear from you! You can report a problem through the Report a Problem option in Visual Studio for Mac IDE. You can track your feedback in the Developer Community portal. For suggestions, let us know through UserVoice.

Release History

Visual Studio 2017 for Mac version 7.7 Preview 1 (

released August 23, 2018

Code Editor

For this release we fixed the following Code Editor issues:



This release includes the following bug fixes and improvements for Xamarin:


  • The Device Manager startup time has been optimized.
  • The available system images now reflect the available options for the selected manifest. This enables Android P support for the device manager when the google manifest is selected in the SDK manager.
  • The device manager no longer relies on the JAVA_HOME environment variable being set and it is exported it for processes that require it.
  • Fixed an issue where AVD Rename would crash the app for the custom ANDROID_AVD_HOME case.
  • Fixed an issue where the Device Manager would not indicate there had been system image installation failure.
  • Fixed an issue where jarsigner would be used instead of apksigner.
  • Fixed an issue where it would not be possible to run an Android app in the emulator.
  • Building an Android project when the Java SDK cannot be found is correctly reported as a build error instead of reporting that the Android SDK cannot be found.


  • Fixed an error updating an Xcode project.
  • Fixed an issue where Automatic iOS provisioning profile dialog did not have clickable links.
  • Fixed an issue where archiving would use a generic iOS device target even if a specific device is selected.


  • Added support for changing the .NET Framework version to use for "Full Framework" projects. Projects are no longer limited to just .NET 4.5.


Release Notes Icon Visual Studio 2017 for Mac version 7.7 Preview 2 (

released September 12, 2018

Code Editor



  • We fixed the following issues:
    • there was a loss of focus when configuring the location of a new project.
    • is not possible to invoke the "Error" window and "Visual Studio Update" window using the keyboard.
    • VoiceOver announces the text typed into password secured fields.
    • VoiceOver focus is not moving to the search results along with the keyboard focus.

.NET Core

Feedback Client

  • We fixed an issue where the Feedback dialog sometimes disappears and is always visible in screenshot.

Web Tools

  • We fixed an issue where pressing Tab doesn't complete the statement in .cshtml files.
  • We fixed an issue where an error is thrown when inserting new line between <div> and </div> in HTML files.



  • We added support for editing Background Modes for WatchKit Extensions.
  • We added support for CarPlay assets.


  • We fixed an issue where Visual Studio for Mac would fail to show new API levels in Minimum and Target Android version drop downs.
  • We improved the error messaging when no JDK is installed. Previously it was not obvious whether the JDK or the Android SDK was not installed.

Team Foundation version control extension – Release Notes

Team Foundation version control support is available as an extension for Visual Studio for Mac. For more information on installing and using the extension, see Connecting to Team Foundation version control.


Released 7/6/2018

Implemented enhancements:

  • Added functionality to change the paths of a WorkingFolder in a Workspace.
  • Added hightlights filtering projects or paths.
  • Improved the amount and details of the feedback messages, including, but not limited to: validations and errors.
  • Minor UI changes.

Fixed bugs:

  • Fixed critical bug obtaining the list of projects from a collection on some TFS On premise servers.
  • Fixed critical bug getting a bad behavior of the version control menu with a Git project and the TFS addin installed.
  • Fixed bug loading remote workspaces.


Released 6/28/2018

Implemented enhancements:

  • Improved Source Explorer experience. The Refresh button has been removed since everything is now refreshed automatically.
  • Simplified workspaces creation process.
  • Minor UI changes.

Fixed bugs:

  • Fixed bug with folders validation. It could affect the creation of workspaces.


Released 6/27/2018

Implemented enhancements:

  • Improved project filter. Added option to filter by server URL and username.
  • Improved Source Explorer loading time.
  • Improvements to the UI refresh process in Source Explorer. Some of the UI elements that have been improved are: The loading indicator and the enable/disable buttons).
  • Added more options to Source Explorer like open folders in Finder, etc.
  • Improved Work Items loading time.
  • Changes in some literals to adapt TFVC branding.
  • More validations: check if the workspace local path exists, etc.
  • Minor UI changes.

Fixed bugs:

  • Added workspace cache to avoid unnecessary request validating project (big performance improvement).
  • Fixed bug opening Source Explorer.
  • Fixed bug creating workspaces. The workspace creation takes some time, moved to another thread.
  • Fixed bug launching OAuth dialog from Source Explorer.
  • Fixed bug relating to adding new files from Source Explorer when there were not any working folder specified in the workspace.
  • Fixed some incorrect literals.
  • Fixed bug with focus on Open from Source Control dialog.
  • Fixed bug that refreshed Source Explorer content after creating a new workspace.


Released 6/11/2018

Fixed bugs:

  • Fixed bug detecting if a project is in some of the TFS Servers (performance).


Released 6/11/2018

Implemented enhancements:

  • New authentication flow.
  • New projects dialog where can easily manage all servers, collections and projects.
  • Added auto discover servers and projects functionality.
  • Added project filter.
  • New dialog where select project paths to map.
  • Added files filter.
  • Added new dialog to create workspaces.
  • Added new option to delete working folders from an existing workspace.
  • Included more detailed forms validation.
  • Improved error management and user feedback. More detailed messages.
  • Improvements in SourceControlExplorer: file types are detected and specific icons are displayed, etc.
  • Improved loading times in SourceControlExplorer.
  • Added new logs option in the Settings.
  • Improvements in addin cache (settings, tokens, etc).
  • Minor UI changes and improvements (loading indicators, etc).

Fixed bugs:

  • Fixed bug authenticating in some TFS Servers using NTLM.
  • Fixed bug creating workspaces related to workspaces cache.
  • Fixed bug refreshing workspace after removing a project.
  • Fixed bug refreshing OAuth token under some conditions.
  • Fixed bug changing Visual Studio theme and minor UI details.
  • Fixed bug getting the workspace owner name.

0.1.1 (Beta)

Released 5/8/2018

Fixed bugs:

  • Fixed bug loading OAuth Webview from some Visual Studio for macOS versions.

0.1 (Beta)

Released 5/8/2018

Implemented enhancements:

  • Basic and OAuth Authentication.
  • Choose server projects.
  • Create, edit and delete Workspaces.
  • SourceControlExplorer.
  • Map and get.
  • Added checkout functionality.
  • Added checkin functionality.
  • Added rename functionality.
  • Added delete folders and files functionality.
  • Added lock and unlock functionality.
  • Added undo changes functionality.

Visual Studio 2017 for Mac Preview Release Notes History

You can view prior Preview versions of Visual Studio 2017 for Mac release notes:

Top of Page