Visual Studio 2017 for Mac Preview Release Notes
This release is not "go-live" and not intended for use on production computers or for creating production code.
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.
- November 19, 2018 – Visual Studio 2017 for Mac version 7.7 Preview 6
- November 7, 2018 – Visual Studio 2017 for Mac version 7.7 Preview 5
- October 24, 2018 – Visual Studio 2017 for Mac version 7.7 Preview 4
- October 2, 2018 – Visual Studio 2017 for Mac version 7.7 Preview 3
- September 12, 2018 – Visual Studio 2017 for Mac version 7.7 Preview 2
- August 23, 2018 – Visual Studio 2017 for Mac version 7.7 Preview 1
released August 23, 2018
For this release we fixed the following Code Editor issues:
- Fixed an issue where incorrect colors were displayed when dragging a document tab.
- Fixed an issue where Ctrl+Right and Ctrl+Left would skip too much text in the editor.
- Fixed an issue where Cmd-click navigation sometimes gets stuck.
- Fixed an issue where Cmd does not light up navigation for symbol under mouse
- Fixed an issue where Breakpoints and caret location were not displayed in the scrollbar.
- Fixed an issue where Extract Interface dialog layout would flicker.
- Fixed an issue where "Copy comments from base" refactoring would suggest including comments from the base class library.
- Fixed an issue where it was not possible to see the mouse over content when using the keyboard.
- Fixed an issue where
CopyCommentsFromBaseCodeRefactoringProviderwould throw an XML parse exception.
- Fixed an issue where an error in document creation causes a cascade of errors leading to a crash.
- Fixed an issue where the text Editor outdents to hard left instead of going back an indent level.
- Fixed an issue where the editor would not render whitespace marks for virtual space.
- Fixed an issue where the regex completion provider would crash.
- Fixed an issue where C# completion improperly escapes \ within @ strings.
- Fixed an issue where code completion would incorrectly insert code.
- Fixed an issue where the IntelliSense window would obscuring code when "Show function type signatures" is enabled.
- Fixed an issue where Minimap could be turned off.
- Fixed an issue where Razor completion would not commit the change if the caret is immediately followed by '}'.
- Fixed an issue where renaming a class would ask to reload the file.
- Fixed an issue where "[TestCaseSource ("xzy")]" was not seen as a test in the text editor.
- Fixed an issue where Alt-shift-left/right would not extend the selection.
- Fixed an issue where an error would be logged for the Text Mate text editor extension.
- Fixed an issue where it was not possible to configure tabs in XAML files with an EditorConfig file.
- Fixed an issue where the Tab size in the editor was wrong.
- 'Find Reference Usages' is now supported.
- 'Find Implementing Symbols' is now supported.
- Fixed an issue where a fatal exception could occur when building a F# project.
- Fixed an issue where the IDE would hang when getting extension methods for F#.
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_HOMEenvironment 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
- 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.
- Fixed an issue where the version control Diff view would not show the correct changed text.
- Fixed an issue where the Class pad shows compiler generated fields and constructors.
- Fixed an issue where an error was logged when the news feed could not be retrieved.
- Fixed an issue where the updater would not display "Checking for updates..." until the channel was changed.
- Fixed an issue where the Sign in button for publishing to Azure was not rendered correctly.
- Fixed an issue where running unit tests always ran a full build.
- Fixed an issue with running NUnit 3 tests due to a misnamed test runner application.
- The Welcome page is no longer displayed when loading a solution from Finder.
released September 12, 2018
- We aligned quote matching behavior to match Visual Studio.
- We fixed an issue where Cut and Paste would not convert
- We fixed an issue where code snippets would fail to load when there is a malformed snippet.
- We fixed an issue where the indentation in multi-line field initializers is wrong when working with arrays.
- We fixed an issue where .editorConfig doesn't work when using .NET Core Rules.
- We fixed an issue where C# indentation inside method is not aligning with existing code.
- We fixed an issue where there is inconsistent indentation between VS Windows and VS Mac.
- We fixed an issue where it is not obvious which "fix all" is which.
- We fixed an issue where intermittent errors would appear after creating a new .NET Core project.
- We fixed an issue where OutputBase no longer includes the build configuration.
- We fixed an issue where Visual Studio for Mac builds all projects instead of just the executable and dependencies only when running the project.
- We fixed an issue where the project GUID changes when building in VS2017 vs building in Visual Studio for Mac.
- 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.
<Import Sdk="Microsoft.NET.Sdk" Project="Sdk.props" />
<Import Sdk="Microsoft.NET.Sdk" Project="Sdk.targets" />
<Sdk Name="Microsoft.NET.Sdk" Version="1.0.0" />
- We fixed an issue where the Feedback dialog sometimes disappears and is always visible in screenshot.
- 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>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.
released October 2, 2018
- We fixed an issue were an exception is thrown when using syntax highlighting in Visual Studio for Mac 7.6.
- We fixed an issue where Visual Studio for Mac IntelliSense does not work correctly in version 7.6.1 (build 9).
- We fixed an issue where Visual Studio for Mac IDE themes look wrong.
- We fixed an issue where deleting emoji in source file creates gray bars.
- We fixed an issue where sorting usings does not work.
- We fixed some editor IntelliSense/Code Generation bugs.
- We fixed an issue where completion suggestion mode does not work as expected in collection initializers.
- We fixed an issue where format document does not use the correct formatting settings.
- We fixed an issue where the indentation after end of method is incorrect.
- We fixed an issue where cut and paste is broken in the editor.
- We fixed an issue with the Oblivion color style.
- We fixed an issue where some C# templates do not work when invoked in the editor.
- We fixed an issue where there are no tooltips on toolbar.
- We fixed an issue where new Application Output windows are created on each run.
- We fixed an issue where tooltips do not close in Visual Studio for Mac.
- We fixed an issue where the user could not type in .json files.
- We fixed an issue where PackageReferences with no version were not supported.
This release adds support for new ARKit 2.0 asset catalog resources:
ARKit 2.0 supports 2D and 3D objects detection.
ARReferenceImage is the new asset catalog type for 2D images that can be used and recognized by ARKit. Width and Height of the
ARReferenceImage can be set in the asset editor so ARKit can render virtual overlays of the correct dimensions. The
ARObject type takes an '.arobject' file that can be created by some ARKit samples.
We also made the following improvements:
- We updated our CoreML support:
- CoreML Model Viewer has been updated to display the new Custom Layers that were introduced with Xcode 10 and iOS 12.
- CoreML code-behind generator has been updated to add more convenience methods.
- We fixed an issue that caused random crashes - Xamarin.MacDev.MobileDeviceException: Device is invalid.
- We fixed an issue where the iOS project properties window for image resource sets incorrect property in .csproj file.
- We fixed an issue with migration from WatchKit to Xamarin.WatchOS.
- With Visual Studio 2017 15.9 and Visual Studio for Mac 7.7, we are moving from Oracle's JDK to a lightweight distribution of Open JDK meant for mobile development. Open JDK will be offered as a component to install along with other Visual Studio for Mac updates and you will be prompted to update your JDK settings to use Open JDK once installed.
- We fixed an issue where the UnitTest text editor extension causes slowness in the IDE.
- We made the following accessibility improvements:
- better contrast in the New Project Dialog
- better contrast in the Exception dialog
- VoiceOver improvements
released October 24, 2018
Summary of What's New in 7.7 Preview 4
- We added new icons to show you when quick fixes are available.
- NuGet updated to version 4.7.
- We now support Publish to folder for ASP.NET Core projects.
Quick fix improvements
Quick fixes can now be applied by using the light bulb or screwdriver icons in the C# editor, or by pressing Option+Enter when your cursor is on a line of code for which an action is available. You will see an error light bulb if there is a red squiggle indicating an error, and Visual Studio for Mac has a fix available for that error.
We also fixed the following issues in this release.
- We fixed an issue where enabling or disabling a breakpoint opens quick fixes menu.
- We fixed an issue where IntelliSense completion commits on ENTER when an item is soft-selected.
- We fixed an issue where an invalid URI exception is thrown on opening file in root directory.
- We fixed an issue where Intellisense stops working on random files.
- We fixed an issue where fix all in file is slow and unreliable, fails silently.
- We fixed an issue where 'CreateChangedEventCodeRefactoringProvider' encountered an error and has been disabled..
- We fixed an issue where 'ReplacePropertyWithBackingFieldWithAutoPropertyCodeRefactoringProvider' encountered an error and has been disabled.
- We fixed an issue where re-entering an event handler, after code generation from
+=, if the corresponding method has been changed causes code generation to fire again.
- We fixed an issue where the mouse cursor is always an arrow and Visual Studio Mac (7.4 Build 884) mouse cursor is always an arrow.
- We fixed an issue where "Show Invisible Characters" setting keeps being reset in 7.6.
- We fixed an issue where it was not possible to create new files for a solution and Error creating file - Index was outside the bounds of the array, new XAML file does not include code-behind.
- We fixed an issue where an error is thrown when creating a file - NullReferenceException: Object reference not set to an instance of an object.
- We fixed an issue where files removed from a project are not deleted when "Delete" is chosen.
- We fixed an issue where NullReferenceException calling NR5CompatibiltyExtensions.GetFullName.
- We fixed an issue where ExtractMethodCodeRefactoringProvider encountered an error and has been disabled.
- We fixed an issue where IntelliSense stops working when creating a new file and Intellisense/Autocomplete constantly failing.
- We fixed an issue where 'add using' writes the wrong reference down for a framework assembly.
- We fixed an issue where "using" imports no longer suggested in the Quick Fix menu and Quick fix does not offer to add using statement if source analysis is disabled.
- We fixed an issue where ToAbstractVirtualNonVirtualConversionCodeRefactoringProvider fails and gets disabled.
- We fixed an issue where an invalid configuration mapping error is displayed when loading an SDK-style project.
- We fixed an issue where it is not possible to open Specflow feature file.
- We fixed an issue where Visual Studio for Mac crashes when restoring packages that have lots of SDK style projects.
- The Update and Restore commands should be disabled for SDK NuGet for .Net Core projects.
- We fixed an issue where refactoring or error info bars would be shown duplicated.
- We fixed an issue where there are shadow artifacts in Tooltips on Mojave.
- We fixed an issue where pinned projects are no longer remaining pinned after a restart of Visual Studio for Mac.
- Visual Studio for Mac now supports .NET Core 2.2.
- We fixed an issue where .NET Standard missing from the target framework list.
- We fixed an issue where creating a new .NET Core project semi-failed.
- We fixed an issue where possible copy paste error in .NET Core options panels.
- We fixed an issue where, after installing .NET Core 2.2 preview, .NET Core 2.1 projects no longer build.
When developing ASP.NET Core applications, there are many different options for hosting your application.
In previous releases we supported publishing your ASP.NET Core applications to Azure App Services. In this release we are adding the ability to publish ASP.NET Core applications to a folder.
After publishing your application to a folder, you can then transfer the files to the remote server, which will host your applications.
When you use the new Folder Publish feature, it will automatically create a Publish Profile (.pubxml file in Properties\PublishProfiles). These profiles can be used in either Visual Studio for Mac, Visual Studio 2017 (Windows) or from the command line with
dotnet build (or MSBuild).
We also fixed the following issues:
- We display more informative error messages when new Azure app services fail to provision.
- We fixed an issue where Visual Studio for Mac fails to debug ASP.NET Core Web App with error
"Debug/netcoreapp2.1/testing.dll file was not found. (MSB3030) (docker-compose)".
- We fixed an issue where the namespace for new Forms Content Page (XAML) in F# is wrong.
- Added support for editing Background Modes for WatchKit Extensions.
- Added support for CarPlay assets.
- Added support for Metal 4v1 and 5v1 to DataSet Asset Catalog editor.
- Added new WatchOS App Icon selectors for the new 40mm and 44mm watches.
- Added support for Apple Watch Series 4 complications.
- Updated the CoreML Model Viewer to display the new Custom Layers that were introduced with Xcode 10 and iOS 12.
- Added support for the AutoFill Credential Provider entitlement.
- Updated the CoreML code-behind generator to add more convenience methods.
- We fixed an issue where saving of "Optimize" metadata for stand-alone image assets in the Properties Pad.
- We fixed an issue where enabling/disabling keychain access groups may not be persisted to the entitlements file.
- We fixed an issue where it was not possible to set launch images for iPhone Xs Max and iPhone XR.
- We fixed an issue where new iOS projects not being being created correctly....
- We fixed an issue where enabling and disabling keychain access groups may not be persisted to the entitlements file.
- When archiving a build for publishing, we make sure to build targeting a generic iOS device in case the project is configured the build to using device-specific builds.
- When archiving a build for publishing, we make sure to save open files in accordance with IDE preferences.
- We fixed an issue where the simulators were not sorting correctly for new iPhone XS and XR devices.
- We now recommend installing Xcode if the version needed by Xamarin.iOS is incompatible.
- Wording and behavior made consistent with Visual Studio on Windows regarding how we handle target framework, minimum and target Android versions.
- The target framework of the project is now controlled more explicitly, first by
<uses-sdk />in AndroidManifest.xml element if it contains the
targetSdkVersionproperty, followed by the project's
TargetFrameworkVersion. Visual Studio for Mac will migrate projects to remove
AndroidUseLatestPlatformSdkif it exists. It will also update AndroidManifest.xml to add
<uses-sdk />if it is missing.
- When publishing to Google Play, we now warn if your app has a targetSdkVersion less than API 26.
- We fixed an issue where the build should fail fast if target framework is not compatible with target device.
- We fixed an issue where Cannot enable "INTERNET" permission on AndroidManifest.xml dialog with F# projects.
- We fixed an issue where Visual Studio for Mac was reporting Execution failed instead of the informing that the emulator was corrupted.
- We fixed an issue where custom commands do not execute when archiving Android app.
- We fixed an issue where the user is not prompted to install Android APIs above 25 if they are not installed.
armeabiABI option has been removed now that it is no longer a supported ABI architecture.
- We fixed an issue where Visual Studio for Mac was unable to connect to Xcode 9.2 after updating to version 7.6 (build 2190).
- We fixed an issue where opening Mac Cocoa project storyboard failed.
We fixed several issues with accessibility support:
- We fixed an issue where typing can be slow in large files when accessibility is enabled.
- Focus order is inappropriate while navigating to the tree items in the left pane of the "Preferences" window.
- Focus order is inappropriate while navigating in reverse order in the toolbar.
- On hitting escape key in "Value Visualizer" window, both the "Value Visualizer" and "Exception Caught" windows are getting closed.
- Voiceover doesn't announce the name of the close button in the pop up dialogs.
- Voiceover announces the controltype of "General" heading in "Choose a template for your new project" dialog inappropriately.
- Voiceover doesn't announce the relation between each of the category and the options under it in "Project Categories" table.
- We fixed an issue where license verification process doesn't use proxy.
- We fixed an issue where the user is unable to log into Visual Studio for Mac.
- Assembly Explorer listing changes method name when hovering mouse over the method/constructor names.
- We fixed an issue where the New Project dialog does not select a recent template by default.
- We fixed an issue where Build project before executing unit tests was incorrectly prompting.
- We fixed an issue where there was a stack overflow on running unit tests.
- We fixed an issue where adding a unit test, Visual Studio for Mac will crash with a stack trace that seems to try to recursively add the unit test.
released November 7, 2018
Summary of What's New in 7.7 Preview 5
- We fixed an issue where you cannot save any edits to Visual Studio for Mac files onto a USB Flash Drive.
- We fixed an issue where copy and paste sometimes fails on Visual Studio for Mac.
- We fixed an issue where XML intellisense autocompletes too early.
- We fixed an issue where there is no syntax highlighting for .vb files.
- We fixed an issue where you are unable to change font colors for VB.net in Visual Studio Community 2017 for Mac.
- We fixed an issue where the Screwdriver icon never goes away in using statements.
- We fixed an issue where application output shows nothing after clearing the console.
- We fixed an issue where "Application output" inside the IDE stops working once cleared.
- We fixed an issue where the text on the Git credentials pop up window was formatted incorrectly.
- We fixed an issue where symlinked files do not have correct define constants.
- We fixed an issue where the publish menu was incorrectly available for all project types.
- We fixed an issue where a null reference exception would be thrown when Publish to Folder for a solution is selected.
- We fixed an issue where the run button is not working.
- The Minimum Android version and Target Android version selectors in the Android Application settings no longer provide "Automatic" options. These often resulted in the AndroidManifest.xml file missing
targetSdkVersionattributes. A manifest missing these values is not practical and additionally can cause issues when publishing to the Play Store.
- We fixed an issue where it is not possible to create a service run configuration.
- We fixed an issue where the binding template of Android Library contains a typo.
- We fixed an issue where trying to upload an ANDROID release to GooglePlay fails with "Version 38 of this app cannot be downloaded by any devices as they will all receive APKs with higher version codes.".
- We fixed an issue where opening Report A Problem also displays "install JDK" dialog.
- We fixed an issue where go to error / location in XAML fails.
- We fixed an issue where cannot add .bat (Windows Batch files) to projects - Visual Studio for Mac hangs indefinitely.
released November 19, 2018
Summary of What's New in 7.7 Preview 6
- We fixed an issue where code refactoring providers would crash.
- We fixed an issue where renaming public types would fail.
- We fixed an issue where a matching brace is inserted even though Insert matching brace option is disabled.
- We fixed an issue where the code issue icon displayed as a wrench, rather than a light bulb, for removing Using directives.
- We fixed an issue where the InfoBar incorrectly adds a hyphen to the end of the displayed text.
- We fixed an issue where the Add Docker command could fail with a NullReferenceException.
- We fixed an issue where Go To Error/Location in XAML would not take you to the correct location.
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.
- 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 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.
- Improved Source Explorer experience. The Refresh button has been removed since everything is now refreshed automatically.
- Simplified workspaces creation process.
- Minor UI changes.
- Fixed bug with folders validation. It could affect the creation of workspaces.
- 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.
- 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.
- Fixed bug detecting if a project is in some of the TFS Servers (performance).
- 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 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.
- Fixed bug loading OAuth Webview from some Visual Studio for macOS versions.
- Basic and OAuth Authentication.
- Choose server projects.
- Create, edit and delete Workspaces.
- 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: