Visual Studio Icon Visual Studio 2017 for Mac version 7.4 Release Notes

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


If you are accessing this page from a non-English language version, and want to see the most up-to-date content, please visit this Release Notes page in English. You can change the language of this page by clicking the globe icon in the page footer and selecting your desired language.

Use Visual Studio 2017 for Mac to build apps for mobile, web, and the cloud with Xamarin and .NET Core, as well as games with Unity.

Download the Current Release of Visual Studio 2017 for Mac

Download Visual Studio 2017 for Mac

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.

How are we doing?

We’d love to hear from you! You can report a problem via the Report a Problem option the Visual Studio for Mac IDE and track your feedback in the Developer Community portal.

Release History

Release Notes Icon Visual Studio 2017 for Mac 7.4 (

released March 5, 2018

For the Visual Studio for Mac 7.4 release, we've taken time to focus on fixing some of the top memory leaks, performance problems, and stability issues that have been reported to us. This release also brings support for Android Oreo 8.1 development and several productivity enhancements for Xamarin developers.

Release Highlights

  • macOS High Sierra is now officially supported.
  • Support for Xcode 9.3.
  • C# 7.1 is now supported (see what's new in C# 7.1).
  • Support for Android 8.1 Oreo.
  • Wireless deployment and debugging for Xamarin.iOS.
  • Core architectural changes were made to the C# editor; both IntelliSense performance/reliability and typing responsiveness are improved as a result.

Issues fixed in this release

Release in Detail

  • Added an Edit > Switch to Suggestion Mode menu, to toggle between IntelliSense suggestion mode and completion mode. In suggestion mode, IntelliSense auto-complete suggestions will not override the text you've written unless you manually choose them from the IntelliSense suggestion list. To switch back to Completion Mode you can choose the Edit | Switch to Completion Mode menu. A default keyboard shortcut of Ctrl+Alt+Space is provided if you're using Visual Studio (Mixed) or Visual Studio (Windows) key binding schemes.

  • Added a Cmd+Shift+P shortcut that will open the Navigate To search box, filtered so you can search for available commands based on your current context.

Debug source files option figure 1
(Figure 1) Command Filtering
  • Debugger source lookup.

    • Added support for the Debug Source Files tab in solution options (Figure 2). To keep the UI clean, this menu appears only after you add the first folder.

      Debug source files option figure 2
      (Figure 2) Debug source files option
    • If you try to navigate to a stack frame or step into a method and the debugger doesn't find source files, a new Source Not Found document (Figure 3) is shown. This document helps to provide some options to locate source files if you have them. This is useful when debugging assemblies that were compiled on CI and user has access to source files and .pdb file.

      New 'source not found' dialog
      (Figure 3) New "source not found" dialog
  • File watcher to detect files added to the project.

    Visual Studio for Mac will now detect files added to or removed from a .NET Core project and update the Solution window with the changes dynamically. This improvement addressed the unload/reload required after EF migrations issue reported in the Developer Community.

  • Use .vs directory for .userprefs

    • To improve compatibility with Visual Studio on Windows the user preferences file generated by Visual Studio for Mac are no longer stored in the solution directory but are now stored in .vs/SolutionName/xs/UserPrefs.xml.


  • We no longer support the “Upload to Xamarin Test Cloud” function in Visual Studio for Mac (invoked by right-clicking the Unit test tree). Moving forwards tests can be submitted through the Visual Studio App Center CLI.

  • We have removed the support for components in IDE. If you open a project that has components already referenced, you will be met with an error. The fix this error, you must edit the .csproj file manually and remove all information in the <XamarinComponentReference/> tags. For more information see the Components migration guide.


  • We've added support for wireless deployment and debugging for iOS or AppleTV devices. When a device is connected via a network and ready to be used for deployment, it now shows up in the device target list, as if the device were connected through USB. (Figure 4):

    Apple device connected over Wi-Fi selected in device list
    (Figure 4) Apple device connected over a network is displayed in device list

    For more information on this feature, see the Wireless Deployment guide.

  • Visual Studio for Mac now asks to unlock the deployment device before launching the app (Figure 5) and does not interrupt the debugging session:

    Alert advising user to unlock iOS device
    (Figure 5) Alert advising user to unlock iOS device
  • Visual Studio for Mac now auto-generates C# bindings for CoreML models when they are added to a project allowing for quick and easy usage of CoreML models.

  • Provisioning Improvements:

    • This release introduces a better fastlane installation workflow. If fastlane is not installed, instead of showing an error dialog asking you to read the provisioning documentation and install fastlane, we provide a way to do it within the IDE.
    • Depending on the internet speed and computer parameters the installation can take up to two minutes. For this reason, fastlane will be downloaded in the background for your convenience.
    • We made a number of UI improvements to the automatic provisioning widget in Info.plist editor. The new widget draws a definite distinction between manual and automatic provisioning modes and communicates provisioning status to the user.


Android 8.1 Oreo is the latest version of Android available from Google. Android 8.1 Oreo offers many new features of interest to Xamarin.Android developers such as Android Go, Neural Networks API, Autofill Framework updates, SharedMemory API, and many more. These APIs are available to Xamarin.Android apps when you use Xamarin.Android 8.2 and later.

  • We've added integration for the Xamarin Android Device Manager (preview) for users with SDK Tools 26 installed. For more information, refer to the documentation.

  • You'll now be warned if the Android emulator is not using HAXM.

Visual Designers

iOS Designer
  • Constraints Mode Key Bindings:

    New key bindings make it easier to work with the new constraints mode (introduced in 15.5). For example:

    • Toggle constraints mode: ⌘ E
    • Temporarily enable constraints mode: Hold ⌃
    • In constraints mode, update constraints; else update frames: ⇧ ⌘ R
  • Trait Variations can now be enabled for tvOS :

    Trait variations can now be enabled for tvOS storyboards and XIBs, which enables variation by light style or dark style.

  • Automatic Zoom Out when dragging large items from the Toolbox:

    The design surface now automatically zooms out when you drag a large item from the toolbox. This makes it easier to place large items on your XIB or storyboard.

  • Zoom Indicator and Selector:

    Indicates current zoom level percentage and enables selecting zoom levels from a pop up list.

Android Designer
  • Android resource parsing and processing has been vastly revamped in this release resulting in increased performance and accuracy across the board.
  • Added Android Oreo (API 26) rendering support.
  • Oreo features like custom fonts and adaptive icons are now supported.
  • Rendering speed improvements.
  • Improved IntelliSense completion experience.


We fixed a number of bugs to improve XAML editing:

  • [FIXED] Inconsistent behavior in XML/XAML editor between vs/vsmac when hitting "ENTER" in to add a new attribute to an element.
  • [FIXED] Many elements are missing from completion: ResourceDictionary, x:Double, x:Key etc.
  • [FIXED] No IntelliSense after typing period in name.
  • [FIXED] One Platform is missing from IntelliSense.
  • [FIXED] Tab key inserts spaces, indenter inserts tabs.
  • [FIXED] XAML IntelliSense lists element properties sorted by length of name.

Xamarin Workbooks and Installer

We have fully split Xamarin Inspector from Xamarin Workbooks. The Inspector extension no longer requires a Workbooks installation to function.

All Xamarin Product release notes

Release Notes Icon Visual Studio 2017 for Mac 7.4.1 (

released March 26, 2018

Release Notes Icon Visual Studio 2017 for Mac 7.4.2 (

released April 3, 2018

This release includes support for Xcode 9.3 and addresses the following issues:

Release Notes Icon Visual Studio 2017 for Mac 7.4.3 (

released April 18, 2018

This release addresses the following issues:

Known Issues

Visual Studio 2017 for Mac Release Notes History

Current Release Notes

Visual Studio 2017 for Mac version 7.4 Release Notes

Visual Studio 2017 for Mac version 7.3 Release Notes

Visual Studio 2017 for Mac version 7.2 Release Notes

Visual Studio 2017 for Mac version 7.1 Release Notes

Visual Studio 2017 for Mac version 7.0 Release Notes

Top of Page