Visual Studio Icon Visual Studio 2019 for Mac Preview Release Notes

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

Get the Preview


Get the Preview of Visual Studio 2019 for Mac by updating to the Preview channel.

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 for Mac, see Mac System Requirements and Mac Platform Targeting and Compatibility.

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

What's New in 8.3 Preview

Visual Studio 2019 for Mac version 8.3 Preview Releases

Release Highlights

Known Issues

Refer to the Known Issues section.


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.

Visual Studio 2019 for Mac version 8.3 Preview 2 (

released August 13, 2019

New Features


In this release we have added improved support for projects that have multi-target frameworks. Some of the features and benefits are detailed below:

  • When editing a file in a multi-target framework project, the target framework can be selected to guide the intellisense in the editor

    Multi-target framework project editor experience in Visual Studio for Mac
  • The editor will show information in IntelliSense and tooltips about APIs that are not available for a particular target framework.

  • We have also added support for debugging against a specific framework:

    Debugging a multi-target framework project in Visual Studio for Mac


New Manage NuGet packages dialog

NuGet packages can now be installed, updated or uninstalled for multiple projects in one step with the Manage NuGet packages dialog:

Managing NuGet packages for the solution in Visual Studio for Mac

The Add Packages dialog has been replaced with a Manage NuGet Packages dialog that has four tabs:

  • Browse - shows packages available from the selected package source.
  • Installed - shows packages installed in the solution, or project if managing packages for a single project.
  • Updates - shows package updates available for the solution, or project if managing packages for a single project.
  • Consolidate - shows packages that have different versions across the solution.

To use the various new tabs, follow the steps below:

To open the Manage NuGet Packages dialog for the solution, do the following:

  1. Make sure the solution is selected in the Solution window.
  2. Right click the solution and select Manage NuGet Packages OR select Manage NuGet Packages from the Project menu.

To install a package into multiple projects, do the following:

  1. Select the package in the Browse tab.
  2. Click the Add Package button.
  3. Check the projects in the Select Projects dialog and click OK, as illustrated below:
Select Projects dialog in Visual Studio for Mac

To update a package in multiple projects:

  1. Select the package in the Updates tab.
  2. Click the Update Package button.
  3. Check the projects in the Select Projects dialog and click OK.

To uninstall a package from multiple projects:

  1. Select the Installed tab.
  2. Select the package you want to uninstall.
  3. Click the Uninstall Package button.
  4. Check the projects you want the package to be uninstalled from and click OK.

To consolidate package in multiple projects:

  1. Select the Consolidate tab.

  2. Select the package you want to consolidate.

  3. Check or uncheck projects in the projects list. By default projects that contain the selected NuGet package will be checked.

  4. Select the package version to consolidate to. By default the latest package version will be selected.

  5. Click the Consolidate button.

    Manage NuGet Packages dialog consolidate tab in Visual Studio for Mac

To manage NuGet packages for a single project:

  1. Select the project in the Solution pad.
  2. Right click the project and select Manage NuGet Packages, and follow the steps you need above. Note that the Consolidate tab will not be displayed but the Browse, Installed, and Updates tabs will be available

.NET Core

We added the ability to select the browser that is used when you run, or debug, your ASP.NET Core web application.

Select browser

This release introduces support for the latest .NET 3.0 Preview (8).


For more information on everything new with .NET Core, see the .NET Core release notes.


Pinned Documents

In this release we have introduced the ability to pin document tabs:

Pinned Tabs
  • You can pin your favorite file-tabs to keep them always open and visible
  • Use the Pin icon, document context menu, or the Pin/Unpin Tab command (⌥⌘P)
  • You can also rearrange pinned tabs by simply dragging them

Welcome Screen – Favorite Keyboard Shortcuts

If you're a new Visual Studio for Mac user, you will be asked to select your favorite Keyboard Shortcut Scheme as part of the first run experience. Of course you can also modify existing schemes or build your own from scratch later under Visual Studio > Preferences.

Welcome Screen – Keyboard Shortcuts


Visual Studio for Mac now supports SourceLink. This allows you to debug into source code from NuGet packages that ship .PDBs with links to source files. Visual Studio for Mac will detect that source files are available and offer to download the source file allowing you to step through package code. SourceLink also works with Mono BCL code allowing you to step into .NET Framework code as well.

Step into External Code option
SourceLink prompt


  • Improved the information displayed in the attach to instance dialog, including process ID
  • Added support for the hex editor when inspecting byte arrays and strings
  • Added support for pointer member access in the debugger, i.e. p->foo->bar
  • Added support for implicit conversions in array initializers, i.e. new byte[] {1,2,3,4}



XAML Hot Reload for Xamarin.Forms

You can now use the public preview of XAML Hot Reload for Xamarin.Forms in Visual Studio and Visual Studio for Mac! XAML Hot Reload enables you to rapidly iterate on your UIs by debugging your app to an emulator, simulator, or physical device, changing your XAML, and hitting save to see those changes immediately reflected on the running app. For more info, check out the XAML Hot Reload documentation.

XAML Hot Reload built into Visual Studio for Mac


For more information on everything new with Xamarin.Forms, see the Xamarin.Forms release notes.


Added Android Q Preview support for Xamarin

You can now use Android Q Beta 4 Final APIs within Xamarin.Android. You can get started with the Android Q Preview by setting Compile using Android version: (Target Framework) to Android 10.0 (Q) under the Build > General tab of the Visual Studio for Mac project property pages. Features new to Android Q include:

  • Support a Dark Theme to ensure a consistent experience for users who enable system-wide dark theme.
  • Support Gesture Navigation in your app by going edge-to-edge and making sure your custom gestures are complementary to the system navigation gestures.
  • Optimize for foldables: Deliver seamless, edge-to-edge experiences on today’s innovative foldable devices.
  • More interactive notifications by enabling suggested replies and actions in your notifications to engage with your users.
  • Better Networking APIs for Wi-Fi network requests and connectivity.
Set the Compile using Android version: (Target Framework) to Android 10.0 (Q).

Android Material Design in the XAML Previewer

Material design using Xamarin.Forms Visual now previews for both iOS and Android in the Xamarin.Forms XAML Previewer. For more information on the XAML Previewer, see the XAML Previewer documentation.


For more information on everything new with Xamarin.Android, see the Xamarin.Android release notes.


The Xamarin Designer for iOS is introducing a new way to work with constraints. When you select a constrainable view, an ellipsis will now appear in the toolbar next to the Constraints Pinning Mode selector. Click the ellipsis to display a popover for editing constraints on the selected view:

Constraints Pining Mode selector


For more information on everything new with Xamarin.iOS, see the Xamarin.iOS release notes.

Bug Fixes


Version Control

  • We fixed an issue where Version control document views are missing with the new editor

Visual Studio 2019 for Mac version 8.3 Preview 1 (

released July 24, 2019



  • We fixed an issue where subsequent queued native Alerts don't sheet properly.

Project System


New Package update information

Package update information is now displayed for SDK style projects in the Solution pad.

  • The way the information is displayed for SDK style and non-SDK projects has been made consistent. An update icon is now displayed with a tooltip showing the updated NuGet package version. The installed version is now displayed next to the NuGet package id for all projects types.

    NuGet package updates in the Solution window in Visual Studio for Mac

.NET Core

Publish support for .NET Core Console and .NET Standard Library Projects

In a previous release we added the ability to publish an ASP.NET Core project to a folder. In this preview we added support to publish .NET Core Console and .NET Standard Library Projects. For more information on how to use this feature, head over to the docs.

ASP.NET Core: Support for launchSettings.json

When developing ASP.NET Core applications, you can configure how the application is launched for development purposes using the launchSettings.json file. For more info on this file, see this section of the environments doc. In launchSettings.json, you can configure the URL for the app to listen on as well as environment variables that are applied on run or debug. With this update, we make it easier for you to collaborate on projects with others that may not be using Visual Studio for Mac. Visual Studio, Visual Studio Code and the dotnet CLI (Command Line Interface) already support this file.

ASP.NET Core: File Nesting support

In this preview, we are also adding automatic File Nesting for ASP.NET Core projects. The auto file nesting rules applied are the same as what you find in Visual Studio. With file nesting enabled, you can focus better on the files that you edit most frequently. Generated files, and less frequently edited files will be nested under other related files.


Web Tools

Version Control

Known Issues

  • Shared Code option is missing when creating a Xamarin Multiplatform app.

Top of Page