Last Update: 3/5/2018 System Requirements
- Visual Studio 2017 for Mac – Stable updater channel
- The latest features and API requires Xcode 9.2 and the bundled macOS SDKs;
- Apple Xcode 9.2 requires a Mac running macOS 10.12.6 (Sierra) or newer;
Your feedback is important to us. If there are any problems with this release, check the Xamarin.Mac Forums and GitHub Issues for existing issues. If you do not find any matching issue, please feel free to start a new discussion and report an issue.
This version Xamarin.Mac correspond to our 15.6 (
- February 23, 2018 - Xamarin.Mac 126.96.36.199
- February 7, 2018 - Xamarin.Mac 188.8.131.52
- January 24, 2018 - Xamarin.Mac 184.108.40.206
- January 10, 2018 - Xamarin.Mac 220.127.116.11
You can learn more about how we ship our releases in the Visual Studio 2017 Release Rhythm document.
February 23, 2018 - Xamarin.Mac 18.104.22.168
This version is included in the Visual Studio 2017 version 15.6 RTW release.
- 3241 - [llvm] Revert "[mini] Align stack when resuming to catch handler"
February 7, 2018 - Xamarin.Mac 22.214.171.124
This version is included in the Visual Studio 2017 version 15.6 Preview 4 release.
- 3089 - [coregraphics] Fix
January 24, 2018 - Xamarin.Mac 126.96.36.199
This version is included in the Visual Studio 2017 version 15.6 Preview 3 release.
- 3140 - [vision] Removes incorrect
- 3145 - [scenekit] Crashes if
- 3146 - [scenekit]
SCNPhysicsWorld.ConvexSweepTestmethod doesn't work
- 6428 - [bcl]
DnsCallbackas async callback causing unhandled exception
- 52729 - [msbuild] Xamarin.Mac and Xamarin.iOS load mismatched assemblies in one build process
January 10, 2018 - Xamarin.Mac 188.8.131.52
This version is included in the Visual Studio 2017 version 15.6 Preview 2 release.
- 32022 - [foundation] Fix DateTime from NSDate seconds (decimal) precision loss when converting.
- 51263 - [corefoundation] Fix CFMessagePort crash when returning data from callback
- 51343 - [appkit] validateMenuItem not called for menu items with c# events for the action
- 59537 - [coreanimation] CATextLayer.Alignment* strings should be CATextLayerAlignment enum / type
- 59635 - [appkit] Window.Toolbar cannot be set to null
- 59647 - [mmp] Release mode AOT should delete dSYM files
- 59911 - [AudioToolbox] Handle is not initialized when trying to create instance of InputAudioQueue
- 59994 - [runtime] Deadlock in the runtime when the GC runs and the XI runtime is releasing managed refs
- 60233 - [runtime] Assertion in dynamic-image.c
- 60277 - [mmp] Fix broken debugging in cases due to stale symbols
- 60294 - [mmp] Add registrar option to help
- 60416 - [appkit] NSCollectionView.ValidateDrop should use 'ref', not 'out'.
- 61101 - NSView.LocationInView does not accept null
- 60935 - NSGestureRecognizer.State binding incorrect causing issues with custom recognizers
- 60821 - ArgumentNullException due to wrong binding in NSWorkspace.SharedWorkspace.OpenFile
- 60377 - MSBuild is getting confused by similar provisioning profiles
- 60545 - Multiple argument generic with contravariant interface as an argument causes MissingMethodException.
- 60771 - Attempting to JIT compile method 'System.Runtime.CompilerServices.Unsafe:Add (byte&,int)' while running in aot-only mode
Integrated Mono Features/Fixes
Additional information can be found in Mono release notes.
What's New in this Release
Base Class Libraries (BCL) Debugging
Developers can now step into the Base Class Libraries code as well as the Xamarin SDK source code while debugging their application. In order to be able to step into the BCL and Xamarin SDK in a project the following has to be configured:
Visual Studio for Mac * Un-check the "Debug code project only; do not step into framework code" option via the Preferences > Debugger menu.
Visual Studio * Un-check the "Enable Just My Code" option via the Tools > Options > Debugging menu.
mmp support for response file
mmp tool has a new option that accept arguments inside a response file.
- 56501 - MSB6002 command-line for MTouch task is too long, > 32000 characters / [mtouch/mmp/bgen] Add support for response files. (#2808)
The mentioned limit is for Windows and the default one for macOS is quite larger.
- 57094 - [generator] Improve BI1014 - include name of unsupported field and valid types
- 58243 - [appkit] Add NSApplicationLaunchUserNotificationKey in more obvious location
- 58251 - [msbuild] When looking for valid signing certificates, print out each invalid certificate and state why it's not valid
- 59186 - [mmp] Improve multiple MM4162 error use case by adding MM0091 error
- 58583 - [mmp] Improve error message when handling mixed-mode assembly references
- 60423 - [security] Add RequestSharedWebCredential overload.
- 60541 - [foundation] Expose initWithDictionary:copyItems: in NS[Mutable]Dictionary
- 57797 - [generator] BindAs support for array of nullable values
- 58792 - [generator] Disallow the use of [Async] when the signature contains ref/out parameters
- 57804 - [generator] Fix slightly incorrect error message when trying to use ref/out parameters with BindAs attributes.
- 57795 - [generator] BindAs attribute for smart enum to multidimensional array generates code that doesn't compile
This document contains a complete list of the API changes since the Xamarin.Mac 4.0 stable release.