Visual Studio Icon Visual Studio 2017 for Mac Preview Release Notes


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


Download

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

Note

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.

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 in the Developer Community portal. For suggestions, let us know through UserVoice.

Known Issues

Refer to the Known Issues section.

Release History

  • July 24, 2018 – Visual Studio 2017 for Mac version 7.6 Preview 5
  • July 11, 2018 – Visual Studio 2017 for Mac version 7.6 Preview 4
  • June 21, 2018 – Visual Studio 2017 for Mac version 7.6 Preview 3
  • May 31, 2018 – Visual Studio 2017 for Mac version 7.6 Preview 2
  • May 07, 2018 – Visual Studio 2017 for Mac version 7.6 Preview 1

Release Highlights

  • The Build Log has been completely revamped to give structured build output that is easier to read and understand.
  • Azure Functions support has been expanded. You can now choose the trigger type when creating a new Azure Functions project. Visual Studio for Mac now also supports publishing Azure Functions to Azure.
  • We've continued to improve performance and stability in Visual Studio for Mac.

Release Notes Icon Visual Studio 2017 for Mac version 7.6 Preview 5 (7.6.0.2086)

released July 24, 2018

Code Editor

Structured Build Output

Project

Performance

.NET Core

  • Fixed an issue where .NET Core project is not restored after changing project properties.

NuGet

Xamarin

Xamarin.Android

  • If Java 9 and above are installed, Visual Studio for Mac will use apksigner to sign Android .apks when publishing through the publishing workflow.

Other

Release Notes Icon Visual Studio 2017 for Mac version 7.6 Preview 4 (7.6.0.2003)

released July 11, 2018

Code Editor

We made the following fixes to Code Editor:

Performance

Project

Structured Build Output

Web Tools

F#

  • Fixed an issue where adding FSharp.Core 4.5.0 NuGet package shows 4.3.3 as the displayed dependency in the solution pad.

Xamarin

Xamarin.Mac

Xamarin.Android

Other

Release Notes Icon Visual Studio 2017 for Mac version 7.6 Preview 3 (7.6.0.1773)

released June 21, 2018

Structured Build Output

Historically the Build Output was simply a capture of the output from the build tasks with minimal formatting. This makes it hard to find specific information, hard to understand for new users, and was often truncated because it was too long to be held in memory. In this release, we are introducing a new Build Output document based on MSBuild binary logs.

The two most obvious changes are that the log no longer shows in the Errors pad and that the output is structured instead of being a flat text log. Clicking the "Build Output" button in the Errors pad now opens a new document with the build output instead of constraining the output to the right hand side of the Error pad.

New Build Output
(Figure 1) New Build Output

When viewing the Build Log you can now enable a diagnostic view of the log by changing the log verbosity in the viewer, instead of changing it in Preferences and re-building the project again. The log can be saved to disk and can be re-opened at any time. We have added support for opening .binlog files directly in Visual Studio for Mac to enable you to do this.

The build output is searchable and it's possible to drill down into the tasks that ran to understand the flow of the build.

Azure Functions

We updated and improved the experience when creating a new Functions project. Previously the new project would default with an HttpTrigger function. Visual Studio for Mac now offers available trigger types that you can select when creating a new project.

New Azure Function; select trigger type
(Figure 2) New Azure Function; select trigger type
New Azure Function; provide trigger details
(Figure 3) New Azure Function; provide trigger details

Code Editor

Editor overtype marker
(Figure 4) Editor overtype marker

Performance

Accessibility

  • Code folding shows when VoiceOver is being used, instead of auto hiding, which is the default behavior.

Project

.Net Core

  • Fixed the default build action for new files.
  • Fixed a UI hang when building an ASP.NET Core Angular project.

NuGet

Web Tools

F#

Xamarin

Xamarin.Forms

Xamarin.iOS

Provisioning

Automatic provisioning in Visual Studio for Mac will now attempt to create and use wildcard App ID and provisioning profiles by default, instead of creating an App ID based on the Bundle Identifier specified in the Info.plist file. Using wildcard IDs by default reduces the number of profiles and IDs that need maintenance in the developer portal.

There are some cases where an explicit App ID needs to be used, based on the entitlements used in the app. The following entitlements are not supported by wildcard App IDs:

  • App Groups
  • Associated Domains
  • Apple Pay
  • Game Center
  • HealthKit
  • HomeKit
  • Hotspot
  • In-App purchase
  • Multipath
  • NFC
  • Personal VPN
  • Push Notifications
  • Wireless Accessory Configuration

If your app uses one of these entitlements, Visual Studio for Mac will attempt to create an explicit App ID instead of a wildcard one.

In addition to wildcard App ID support, the following issues have been fixed:

Xamarin.Android

Android SDK Manager

  • Fixed an issue showing component licenses on installation.
  • Fixed a threading issue when downloading components that impacted the UI thread.

Android Device Manager

  • Fixed an issue starting emulators that required a system image to be download before starting.

Other

Release Notes Icon Visual Studio 2017 for Mac version 7.6 Preview 2 (7.6.0.947)

released May 31, 2018

Code Editor

This release addresses a number of issues with the code editor:

Project

  • We fixed an issue where creating a new Functions project would result in IntelliSense errors until the project was closed and reopened.
  • The Clean target now runs asynchronously.

Debugger

Performance

We fixed the following performance related issues:

Shell

This release introduces the following feature:

  • It is now possible to create an Interactive Workbook from the Welcome Page if Workbooks is installed.

The following issues were addressed in the Visual Studio for Mac Shell:

Version Control

NuGet

  • We now support no-op restores on opening a solution. If the package references have not changed a then a no-op restore will occur.

.Net Core

  • When the ASP.NET Core addin tries to install the HTTPS development certificate, the macOS message dialog that asks for the username and password will now display:

    dotnet-dev-certs wants to make changes.

  • We fixed an issue that where it wasn't possible to add declarations to an empty C# file using suggestions from IntelliSense.

F#

This release introduces the following feature:

  • We updated the version of Xamarin.Forms that is referenced in new projects to 3.0.

We fixed the following issues for F# developers:

Web Tools

Azure

  • It is now possible to publish your Azure Function. Right click the Function project and select Publish, then create or publish to an Azure App Service.
Azure Functions publishing; Create a new App Service
(Figure 5) Azure Functions publishing; Create a new App Service
Azure Functions publishing; Configure Storage Account
(Figure 6) Azure Functions publishing; Configure Storage Account

Xamarin

Xamarin.iOS

We fixed the following issues with iOS projects:

Xamarin.Android

Xamarin.Forms

Release Notes Icon Visual Studio 2017 for Mac version 7.6 Preview 1 (7.6.0.711)

released May 7, 2018

Code Editor

Performance

Shell

Accessibility

NuGet

  • The NuGet SDK Resolver that is included with Mono's MSBuild is now supported by Visual Studio for Mac. This allows SDKs to download from NuGet and consumed by SDK style projects.

F#

Xamarin

Visual Designers

Android Designer
  • Full-fidelity layout editing: your XAML modifications are now preserved even in design mode.
  • Updated renderer to latest Android Oreo.
  • IntelliSense performance improvements.

Xamarin.iOS

  • ClassKit entitlements: ClassKit enables features in your education apps for iPad that can be used by educational institutions with Apple School Manager and Managed Apple IDs.
  • Visual Studio for Mac will now alert you if a particular iOS or Mac constructor (from Xamarin.iOS or Xamarin.Mac, respectively) is unavailable due to deprecation or introduced into a later version of the OS than the version the project is targeting (e.g. the "Deployment Target" as set in the Info.plist).
  • Fixed an issue where IWKNavigationDelegate has two interface methods, and only one is shown in IntelliSense.

Xamarin.Mac

  • Fixed a number of visual glitches when publishing Mac apps.

Known Issues

  • Already installed Android SDK is not detected in the installer (if installed through Android Studio).
  • Razor TagHelpers in project aren’t refreshed on build.
  • CSS Class IntelliSense in _Layout.cshtml, but not in views.
  • In Razor, toggle comments does not work in HTML.
  • Razor: indented tag content indentation bad.
  • Typing a tag in a for loop is changed to textarea (aspnet/Razor/issues/2200)

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 the Connecting to Team Foundation version control guide.

0.3.1

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.

0.3

Released 6/27/2018

Implemented enhancements:

  • Improved project filter. Added option to filter by server URL and username.
  • Improved Source Explorer loading time.
  • Improvements in the refresh process in Source Explorer (loading indicator, disable/enable buttons, etc).
  • 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 adding new files from Source Explorer if there are not any working folder in the workspace.
  • Fixed some incorrect literals.
  • Fixed BUG with focus on Open from Source Control dialog.
  • Fixed BUG refreshing Source Explorer content after create a new workspace.

0.2.1

Released 6/11/2018

Fixed bugs:

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

0.2

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.

Top of Page