Share via

Xamarin.Mac 5.6 Release Notes

  • Article

System Requirements | What's New | Blogs | Open Source

Requirements

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

What's New in this Release

Release History

This version of Xamarin.Mac corresponds to our 16.0 (d16-0) milestone.

  • April 2, 2019 - Xamarin.Mac 5.6.0.25
  • March 20, 2019 - Xamarin.Mac 5.6.0.25
  • March 5, 2019 - Xamarin.Mac 5.6.0.23
  • January 23, 2019 - Xamarin.Mac 5.6.0.10
  • December 4, 2018 - Xamarin.Mac 5.3.1.28

You can learn more about how we ship our releases in the Visual Studio 2019 Release Rhythm document.

April 2, 2019 - Xamarin.Mac 5.6.0.25

This version is included in Visual Studio for Mac 8.0 and Visual Studio 2019 version 16.0.

Note: Due to close release dates this version does not include Xcode 10.2 API but is compatible with the Xcode 10.2 toolchain. A newer version of Xamarin.Mac based on d16-0 and includes Xcode 10.2 API will be available shortly. If required the latest 5.4 release (based on d15-9) is available and include full support for Xcode 10.2.

March 20, 2019 - Xamarin.Mac 5.6.0.25

This version is included in Visual Studio for Mac 8.0 Preview 4.

Enhancements

  • GitHub 5688 - [msbuild] Support UseHardenendRuntime in code signing. Add <UseHardenedRuntime>true</UseHardenedRuntime> in your csproj to run your app with additional security and resource access protections. Note: this is required to upload a macOS app to be notarized

Issues Fixed

  • GitHub 5672 - [msbuild] Xamarin.Mac now has a dedicated FrameworkList file for the Full profile. This fixes NuGet package reference issues such as System.Memory.dll not being copied properly

March 5, 2019 - Xamarin.Mac 5.6.0.23

This version is included in Visual Studio 2019 version 16.0 beta 3.

Issues Fixed

  • GitHub 5345 - [mapkit] Add missing [NullAllowed] in initWithAnnotation:reuseIdentifier:
  • PR 5423 [appkit] Fix crash when disposing shared NSFont instances

Integrated Mono Features/Fixes

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

January 23, 2019 - Xamarin.Mac 5.6.0.10

This version is not installed by default with Visual Studio 2019 version 16.0 preview 2 release. To install it please follow the instructions from this document.

Enhancements

  • GitHub 3543 - [macOS] Improve NSMenu performance
  • GitHub 3577 - [documentation] Update MM0134 error
  • GitHub 3584 - [macOS][msbuild] Cache ACTool results to avoid re-running it with no source code changes
  • GitHub 3647 - [documentation] Replace Bugzilla references by GitHub in error messages
  • GitHub 4435 - [mmp] Add rpath to MonoBundle folder if we bundle any NativeReference
  • GitHub 4606 - [CoreFoundation] Implement missing dispatch API
  • GitHub 4698 - [CoreGraphics] Add MatrixOrder overload for Scale, Rotate and Translate
  • GitHub 4713 - Add several missing PrintCore APIs
  • GitHub 4740 - [AppKit] Add missing bindings for NSLayoutManager
  • GitHub 4825 - [mmp] Add MM2110 error when combining partial static registrar and linking
  • GitHub 4837 - [AppKit] Fixed ValidateProposedFirstResponder so it can be overridden
  • GitHub 5039 - [macOS] Add missing NSScrollView.AddFloatingSubview binding
  • GitHub 5121 - [documentation] Update MM2108 error

Issues Fixed

  • GitHub 4039 - [SceneKit] Avoid possible NullReferenceException in ScnTool task
  • GitHub 4558 - [AppKit] Add missing [NullAllowed] on NSView.NextKeyView
  • GitHub 4988 - [MediaPlayer] Fix NullReferenceException in MPNowPlayingInfoCenter when encountering null dictionary entries
  • GitHub 4990 - [macOS] Fix logic to include branch name in packages so it's displayed in the IDE's "About" page
  • GitHub 5148 - [Foundation] Ensured we use the cookies from the cookie storage in NSUrlSessionHandler
  • GitHub 5190 - [Foundation] Respect HttpClient.Timeout for NSUrlSessionHandler
  • GitHub 5243 and 5248 - [mmp] Add rpath during compile and not after via install_name_tool to avoid code signing issues
  • GitHub 5309 - [Foundation] Fix InvalidCastException in NSUrlSessionHandler.CreateConfig on macOS 10.9

Integrated Mono Features/Fixes

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

December 4, 2018 - Xamarin.Mac 5.3.1.28

This version is not installed by default with Visual Studio 2019 version 16.0 preview 1 release. To install it please follow the instructions from this document.

Enhancements

  • 3675 - [bgen] Remove unneeded bmac-mobile-mono from binding projects and stop shipping it
  • 4255 - [registrar] Ignore availability warnings from clang
  • 4525 - [scenekit] Add advice to SCNMatrix4 about it's row major representation
  • 4549 - [mtouch/mmp/docs] Improve MT0091 to include how to enable the linker
  • 4688 - [coremedia] Expose the CMSampleAttachmentKey interface.
  • 4813 - [foundation] Add bindings for NSMutableDictionary addEntriesFromDictionary:

Issues Fixed

  • 4102 - [runtime] Add support for delegates as return values in protocol members
  • 4611 - [metal] Fix incorrect structure sizes in Metal/Defs.cs
  • 4988 - [mediaplayer] Fix NRE in MPNowPlayingInfoCenter wrt null dictionary entries

Integrated Mono Features/Fixes

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

API Diff

This document contains a complete list of the API changes since the Xamarin.Mac 5.2 stable release.

Feedback welcome

Your feedback is important to us. If there are any problems with this release, check the Xamarin.Mac Forums and Xamarin Mac/iOS Github Repository 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:

Contributors

A big Thank You! to contributors who made improvements in this release: