Warning This document is still work-in-progress/incomplete.
We're excited to announce our .NET 10 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:
Requirements
It's highly recommended to use Xcode 17.0+ (which requires macOS 15.? (Sonoma)). Earlier versions of Xcode may work, but some features won't be available.
With the release the minimum supported OS versions can be targeted for apps:
- iOS: 12.2 (to be confirmed)
- macOS: 11 (to be confirmed)
- tvOS: 12.2 (to be confirmed)
- Mac Catalyst: 13.1 (to be confirmed)
Note: while we support macOS 12, we're only testing on OS versions that Apple supports. At the time of this writing this means we're only testing on macOS 13+.
Getting started
In contrast to how Xamarin.iOS and Xamarin.Mac were shipped (as installable *.pkg
files), our .NET SDKs are shipped as workloads in the .NET world. This means that the first step is to getting started is to install .NET 10.0.100 (or later).
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 16.0:
- iOS 19.0
- macOS 16.0
- tvOS 19.0
- Mac Catalyst 19.0
What's Changed
Xcode 17
We've added support for Xcode 17 + many new APIs in iOS 19, tvOS 19, macOS 16 and Mac Catalyst 19.
The trimmer is enabled by default in more configurations
The trimmer is now enabled in the following configurations:
- iOS Simulator/arm64 (all configurations)
- tvOS Simulator/arm64 (all configurations)
- Mac Catalyst/arm64 (all configurations)
Reference: https://github.com/xamarin/xamarin-macios/issues/21444
...
New Contributors
Changelog
Full changelog
Breaking Changes
Known Issues
FAQ
Feedback
File issues here: https://github.com/xamarin/xamarin-macios/issues/new.
Contributing
Bindings
- README
- xcode13.0 Binding Status
- xcode13.1 Binding Status
- xcode13.2 Binding Status
- xcode13.3 Binding Status
- xcode13.4 Binding Status
- xcode14.0 Binding Status
- xcode14.1 Binding Status
- xcode14.2 Binding Status
- xcode14.3 Binding Status
- xcode15.0 Binding Status
- xcode15.1 Binding Status
- xcode15.3 Binding Status
- xcode15.4 Binding Status
- xcode16.0 Binding Status
- xcode16.1 Binding Status
- xcode16.2 Binding Status