.NET release notes

---

[These notes are incomplete and still in progress]

---

This release contains support for the following OSes, and the OS version we have bindings for:

• iOS 15.4
• macOS 12.3
• tvOS 15.4
• Mac Catalyst 15.4

Shipping changes

Shipped as workloads: https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-workload-install

Installed by dotnet workload install [ios|macos|tvos|maccatalyst]

Create new app from a template with:

dotnet new ios|macos|tvos|maccatalyst

Get a full list of available templates with:

dotnet new --list --tag Mobile

Getting Started | What's New | Known Issues | Blogs | Feedback | Open Source

Requirements

• Xcode 13.3
• macOS 12.0 (Monterey)

What's New in this Release

Everything.

Notable Changes

Removed OpenTK dependency

https://github.com/xamarin/xamarin-macios/issues/13160

macOS

macOS is using the CoreCLR runtime instead of the Mono runtime.

There are a few incompatibilities between CoreCLR and Mono, those are listed here.

Exception marshalling is enabled by default

Cost: some performance

Differences in the CoreCLR runtime.

Release History

First release!

Issues Fixed

• {Bugzilla Number}: {Title of the bug}
• {DevCom Title}

Breaking Changes

See also Breaking Changes

• {Bugzilla Number}: {Title of the bug}
• {DevCom Title}

Known Issues

See [Known issues in .NET](Known issues in .NET)

{Title}

{Paragraph detailing known issue} {Links to respective bug or devcom item}

API Changes / API Diff

• {API Change}

Frequently Asked Questions

What will happen with the old-style Xamarin.iOS and Xamarin.Mac products?

We'll continue to ship Xamarin.iOS and Xamarin.Mac separately for a while, but they will eventually be discontinued.

Ref: <link to blog post? documentation?>