.NET 12 release notes

Warning

This document is still work-in-progress/incomplete, and also contains references to potential future changes which may or may not happen.

We're excited to announce our .NET 12 SDK release!

Note: these are the base SDKs that add support for the platforms in question, if you are looking for .NET MAUI (which is built on top of our SDKs), go here instead: https://docs.microsoft.com/en-us/dotnet/maui/.

Getting Started | What's New | Known Issues | Feedback | FAQ

Versions

This release consists of the following versions:

• iOS: 28.0.?????
• tvOS: 28.0.?????
• macOS: 28.0.?????
• Mac Catalyst: 28.0.?????

Requirements

This release requires Xcode 28.0 or later, which requires macOS Golden Gate 27.? or later.

Apps can target these minimum OS versions:

• iOS: 15.0 (to be confirmed)
• macOS: 14.0 (to be confirmed)
• tvOS: 15.0 (to be confirmed)
• Mac Catalyst: 17.0 (to be confirmed)

Note: while we support macOS 14, we're only testing on OS versions that Apple supports. At the time of this writing this means we're only testing on macOS 15+.

Getting started

The first step is to install .NET 12.0.100.

Then install the workload corresponding with the desired platform:

$ dotnet workload install ios # other workloads: macos, tvos, and maccatalyst

Create new app from a template with:

$ dotnet new ios # 'dotnet new list --tag Mobile' will show all available templates

Finally build and run the new app in the simulator

$ dotnet run

What's New in this Release

This release contains SDKs for the following four platforms: iOS, tvOS, Mac Catalyst and macOS, and has support and bindings for the OS versions that were shipped with Xcode 28.0:

• iOS 28.0
• macOS 28.0
• tvOS 28.0
• Mac Catalyst 28.0

What's Changed

...

New Contributors

Breaking changes

Known Issues

See Known issues

FAQ

Feedback

File issues here: https://github.com/dotnet/macios/issues/.