Xamarin.Mac 6.8 Release Notes

  • Article

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

To see installation instructions for both Visual Studio for Mac and Visual Studio 2019, please visit Installing Xamarin

Requirements

  • The latest features and APIs require Xcode 11.2 and the bundled iOS, tvOS and watchOS SDKs
  • Apple Xcode 11.2 requires a Mac running macOS 10.14.4 (Mojave) or newer
  • Visual Studio 2019 or Visual Studio for Mac

What's New in this Release

Warning

Apple has removed support for executing 32 bit applications in macOS 10.15 Catalina. See our blog post to see how this can affect your applications when using Xamarin.Mac 6.2 (or later).

Release History

This version of Xamarin.Mac corresponds to our 16.4 (d16-4) milestone.

  • December 11, 2019 - Xamarin.iOS 6.8.3.0
  • November 11, 2019 - Xamarin.Mac 6.8.2.2
  • November 4, 2019 - Xamarin.Mac 6.8.1.17
  • October 17, 2019 - Xamarin.Mac 6.8.1.1

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

December 11, 2019 - Xamarin.Mac 6.8.3.0

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

November 11, 2019 - Xamarin.Mac 6.8.2.2

This version is included in Visual Studio for Mac 8.4 Preview 2.1.

This release includes new and updated API to support Xcode 11.2. For more information you can view our release notes for 13.6.

Enhancements

  • 7309 - [Generator] Allow 1 level nested classes

November 4, 2019 - Xamarin.Mac 6.8.1.17

This version is included in Visual Studio for Mac 8.4 Preview 2.

Issues

  • 17416 - [Runtime] Fix Socket.BeginConnect so it does not complete too early when not using callback
  • 17422 - [Profiler] Fix coverage profiler on macOS
  • 17524 - [Debugger] Avoid cutting exceptions in stack traces
  • 17530 - [Runtime] Update NTLM authentication protocol related sources
  • 17240 - [Runtime] Add drawing type converters to mobile profiles

Enhancements

  • 7164 - [Linker] Ensure removal of NSUrlSessionHandler if unused

October 17, 2019 - Xamarin.Mac 6.8.1.1

This version is included in Visual Studio for Mac 8.4 Preview 1.

This release includes new and updated API to support Xcode 11.1. For more information you can view our release notes for 6.4.

Enhancements

  • 6863 - [Generator] Provide clear error message on type mismatch with BindAs error

Issues

  • 5603 - [Network] Add currentPath property to NWPathMonitor
  • 6552 - [MSBuild] Fix building with NETStandard libraries
  • 6443 - [Foundation] Allow users to explicitly bypass the background session check
  • 6762 - [Foundation] Ensure that we allow cellular data by default
  • 6883 - [Registrar] Ignore method encodings when processing copyback arguments in the dynamic registrar
  • 6704 - [Foundation] Ensure that a collection in NSUrlSessionHandler is not modified during the loop
  • 6828 - [Generator] Handle subclasses of NSObject as ref/out parameters in third-party libraries
  • 6346 - [Linker] Fix NullReferenceException when System.Linq.Queryable is used
  • 6711 - [Linker] Always preserve INativeObject (interface) on types
  • 6688 - [NaturalLanguage] Fix NullReferenceException in NLLanguageRecognizer Community Contribution ❤️

Known Issues

Using an older Xcode version

Using an older Xcode version (than the one mentioned in the above requirements) is often possible. For more information see the following documentation.

API Diff

The following documents contains a complete list of the API changes since the Xamarin.Mac 6.6 stable release:

Integrated Mono Features/Fixes

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

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 external contributors who made improvements in this release: