Xamarin.Mac 5.0 Release Notes

System Requirements | What's New | No Known Issues | Blogs | Open Source

This version of Xamarin.Mac corresponds to our xcode10 milestone. This is based on our stable d15-8 milestone, i.e. Xamarin.Mac 4.6.x.


  • The latest features and APIs require Xcode 10 and the bundled macOS SDK
  • Apple Xcode 10 requires a Mac running macOS 10.13.6 (High Sierra) or newer

What's New in this Release

Support for Xcode 10

For more information you can consult the Xcode 10 release notes from Apple.

Support for macOS 10.14

The following new frameworks were added in macOS 10.14:

  • NaturalLanguage
  • Network

Most other frameworks were also updated. See our API diff to browse the latest changes.

For more information you can consult the macOS 10.14 release notes from Apple.

Other Changes

  • Apple is deprecating OpenGL and related API in favor of Metal;
  • Apple removed support for stdlibc++. Using C++ code now requires the use of libc++.

Release History

  • October 1, 2018 - Xamarin.Mac

October 1, 2018 - Xamarin.Mac

This is the first release based on the Xcode 10. It contains bindings to the new APIs introduced in macOS 10.14 and Xcode10.

New frameworks

This includes the following frameworks

  • Network (sample)
  • iTunesLibrary

New CoreImage filters

New CoreImage filters includes:

  • CIAreaMinMax
  • CICameraCalibrationLensCorrection
  • CICoreMLModelFilter
  • CIDither
  • CIGuidedFilter
  • CIMeshGenerator
  • CIMix
  • CISaliencyMapFilter
  • CISampleNearest

Using an older Xcode version

Using an older Xcode version (than the one mentioned in the above requirements) is often possible, but some features may not be available. Also, some limitations might require workarounds, e.g.:

  • The static registrar requires Xcode headers files to build applications, leading to MM0091 or MM4109 errors if API are missing. In most cases enabling the managed linker will help (by removing the API).

API Diff

The following documents contains a complete list of the API changes since our (4.4) stable release:

Integrated Mono Features/Fixes

Xamarin.Mac uses a customized runtime and base class libraries (BCL) from Mono.

Additional information can be found in Mono release notes.


Your feedback is important to us. If there are any problems with this release, check the Xamarin.Mac Forums and xamarin-macios Issue Tracker for existing issues. If you do not find any matching issue, please feel free to start a new discussion and report an issue.

Open Source

Xamarin.Mac is based on the following open-source repositories: