Visual Studio Icon Visual Studio 2019 for Mac Release Notes


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


Download

Click the button to download the latest version of Visual Studio 2019 for Mac. For information on the system requirements see the see Mac System Requirements and Mac Platform Targeting and Compatibility guides.

For instructions on installing and updating Visual Studio 2019 for Mac, see the Install Visual Studio for Mac guide.

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

Important

Visual Studio 2019 for Mac (version 8 and higher) is not supported on Mac OS X 10.11 (El Capitan) or lower. If you have Visual Studio 2017 for Mac (version 7), you will not be shown an update to Visual Studio 2019 for Mac. Installation will also be blocked. To resolve this issue, update to macOS 10.12 (Sierra) or higher


What's New in Visual Studio 2019 for Mac

Visual Studio 2019 for Mac version 8.1 Releases

Visual Studio 2019 for Mac Blog Posts

The Visual Studio Blog is the official source of product insight from the Visual Studio Engineering Team. You can find in-depth information about the Visual Studio 2019 for Mac releases in the following posts:

Release Highlights

This release contains the following highlights:

  • The new C# editor is enabled by default. It features an updated, fully native UI, built on top of the reliable Visual Studio foundation.
  • Support for .NET Core 3 Preview 3, 4, and 5. For Preview 6 support, check out the next Preview.
  • Three new ASP.NET Core templates for Single Page Apps. These are the same templates provided by the dotnet command line tool and Visual Studio on Windows.

Known Issues

Important

If you were previously using .NET Core v2.2.1xx with Visual Studio for Mac 8.0, you'll need to manually update to a supported version of .NET Core, as listed in the .NET Core Support guide. We recommend either 2.1.700 or 2.2.300.

Refer to the Known Issues section for all known issues.


Visual Studio 2019 for Mac version 8.1.5 (8.1.5.9)

released July 9, 2019

This release addresses the following issues:

Visual Studio 2019 for Mac version 8.1.4 (8.1.4.5)

released July 2, 2019

This release addresses the following issues:

Visual Studio 2019 for Mac version 8.1.3 (8.1.3.19)

released June 27, 2019

This release addresses the following issues:

  • AXML files are still not saving.
  • The "Publish in version control" option is always disabled.
  • Adding Docker Compose support to an HTTPS enabled .NET Core project fails with a Kestrel exception regarding the self-signed dev certificate not being trusted/found.
  • "The application exited with code: 255" displays in 'Application Output' window after debugging a docker-compose project then debugging the web application.
  • Cannot debug a normal console application on macOS Catalina.
  • Visual Studuo for Mac crashes on macOS Catalina when you try to open a solution.

Visual Studio 2019 for Mac version 8.1.2 (8.1.2.2)

released June 23, 2019

This release addresses an issue where a missing XAML file breaks IntelliSense.

Visual Studio 2019 for Mac version 8.1.1 (8.1.1.27)

released June 20, 2019

This release addresses the following issues:

Visual Studio 2019 for Mac version 8.1 (8.1.0.2742)

released June 13, 2019

Installer

  • We moved the Android permissions fixes to install-time.
  • We've improved both the design and logic of the Visual Studio for Mac installer in this release. This presents all available options in a much clearer way, allowing you to make an informed decision on exactly what you want to install.
New Component Selection Screen

New C# Editor

When we released Visual Studio 2019 for Mac in April, we offered an entirely new C# editor as an opt-in experience. We wanted to ensure that the new editor meets our standards of performance and reliability before promoting it to the default editor within Visual Studio 2019 for Mac. Additionally, we wanted to ensure no major gaps existed in behavior or functionality between the legacy editor and the new editor.

After a lot of testing, bug fixing, and many conversations with our community, we believe the editor is now at a point where it can be the default experience.

The new editor features an updated, fully native UI built on top of the reliable Visual Studio foundation. You’ll find several additional features that close the gap between the old and new editor in addition to some that were explicitly requested by the Visual Studio for Mac user community.

New editor features in Visual Studio for Mac

The new Visual Studio for Mac editor brings the following features:

  • Native macOS (Cocoa-based) user interface (tooltips, editor surface, margin adornments, text rendering, IntelliSense)
  • Support for native text inputs
  • RTL/BiDi language support
  • Common Visual Studio Platform core
  • Roslyn 3
  • Multi-caret support
  • Word Wrap
  • Update IntelliSense UI
  • Improved Find/Replace

Snippet Support in Editor

You can now use Snippets in the new editor, by using [TAB]-[TAB] when a snippet is selected in the completion window.

Code Snippets

Format Selection

You can now Format Selection when a selection is highlighted and you use either the Format hotkey or the Format menu command.

Format Selection

Error marker margin in scrollbar

Errors and messages will now be marked in your scroll bar so you can quickly navigate between these within your code. Clicking on the marker will navigate your caret to the location of the error or message.

Inline Lightbulbs

Visual Studio 2019 for Mac now supports inline lightbulbs for suggestion fixes to your code. When an underline appears, hover over the code and click the lightbulb that appears to select from a list of suggested fixes.

Inline lightbulbs

Multiple Carets

See the new Edit > Multiple Carets menu for improved support for multiple carets with advanced caret manipulation commands as already available in Visual Studio on Windows. Key bindings for caret manipulation have the same defaults as on Windows and can be customized in preferences.

Multiple Carets
  • The Go To Base navigation command and menu item has been added.
  • The Go To Line Number navigation command was added.

ASP.NET Core templates for Single Page Apps (SPAs)

In this release, we’re including three new templates in Visual Studio for Mac, the same templates provided by the dotnet command line tool and Visual Studio on Windows:

These templates provide a starting point with a sample client-side application written using each of the technologies above. The application consumes data provided by an ASP.NET Core API backend. The project files generated by these templates are setup to build the TypeScript and JavaScript assets when you run your application, so that you can stay focused on building your app without leaving the IDE.   We’ve also added a new Razor Class Library template to make it easier to package and reuse your Razor views, pages, controllers, page models, view components, and data models. You can learn more about this in the ASP.NET Core Razor Pages documentation.

.NET Core

ASP.NET Core

Unity

  • We optimized performance of the debugger when attaching to Unity projects. You can also enable the Preferences > Source Analysis > Enable source analysis of whole solution feature in Visual Studio for Mac to make attaching even faster.

Debugger

  • You can now move the instruction pointer around while debugging .NET Core projects using "Set Next Statement"
Set Next Statement

Shell

  • It is now possible to close all tabs to the right of the selected tab using the tab bar context menu.
Close to the right

Start Window

Web Tools

Assembly Browser

Project System

Version Control

NuGet

Xamarin

iOS Designer

Android Designer

You can now edit Android layout files side-by-side with a real-time designer view. This experience allows you to see changes you make to an Android layout file on the fly as you are editing, greatly improving the efficiency while editing these files.

Android Designer split-view

Forms Designer

Xamarin.iOS

Xamarin.Android

Other fixes


Feedback

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, including suggestions, in the Developer Community portal.


Known Issues

The following is a list of all existing known issues in Visual Studio 2019 for Mac version 8.1:


Visual Studio for Mac Release Notes History

You can view prior versions of Visual Studio for Mac release notes on the Release notes history page.


Top of Page