KEMBAR78
Releases · dotnet/macios · GitHub
Skip to content

Releases: dotnet/macios

.NET 10.0.1xx RC 2 (10970)

15 Oct 06:44
042ba3e

Choose a tag to compare

Pre-release

We're excited to announce our second release candidate for .NET 10!

Note: these are the base SDKs that add support for the platforms in question. For MAUI (which is built on top of our SDKs), visit: https://learn.microsoft.com/dotnet/maui/.

This release consists of the following versions:

Full release notes: .NET 10 release notes
Known issues: Known issues in .NET 10

Installation

You can use workload set version 10.0.100-rc.2.25513.4 in order to install these versions of the SDKs.

Please make sure to be using the corresponding preview of the .NET SDK 10.0.100 before issuing the dotnet workload install
command below. You can validate your installed dotnet version using dotnet --version do make sure it shows 10.0.100 or greater before proceeding.

dotnet workload install <workload id(s)> --version 10.0.100-rc.2.25513.4

Available workload ids

Example command installing all listed workloads.

dotnet workload install ios tvos macos maccatalyst maui android --version 10.100.0-rc.2.25513.4

You can use dotnet workload --info to validate the workload versions installed in your system.

What's Changed

Xcode 26 support

This release includes support for Xcode 26.

What's Changed

Read more

.NET 9 - Xcode 26.0 support (9752)

15 Oct 06:44
177f431

Choose a tag to compare

Note

Xcode 26.0 is required with this release. Xcode 26.0 requires macOS 15.6+.

This is a servicing release to the previous .NET 9 release, mainly adding support for Xcode 26.0.

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

Versions

This release consists of the following versions:

Installation

You can use workload set version 9.0.306 in order to install these versions of the SDKs.

Please make sure to be using the latest .NET SDK 9.0.306 before issuing the dotnet workload install command below. You can
validate your installed dotnet version using dotnet --version do make sure it shows 9.0.306 or greater before proceeding.

dotnet workload install <workload id(s)> --version 9.0.306

Available workload ids

Example command installing all listed workloads.

dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.306

You can use dotnet workload --info to validate the workload versions installed in your system.

Breaking changes

Resource validation

We've added validation to detect if multiple different resources targets the same location in the app bundle, in which case we'll now:

  • Issue a build warning when this situation is detected.
  • Not copy any of the resources into the app bundle (previous behavior was undefined, any of the resources could end up winning).

One scenario where this has known to cause problems is in MAUI projects, when:

  • There are resources in the Platforms/iOS/Resources directory.
  • The project file adds any of these resources to the build, as MauiImage items for instance.

This leads to duplicates, because:

  • All resources in the Platforms/iOS/Resources directory are added to the build by default.
  • MAUI will process (resize) MauiImage items, and add those resized images to the build.

There are multiple ways to fix this, here are a few:

  1. Remove all MauiImage from the BundleResource item group (where they were added by default):

    <ItemGroup>
    	<!-- ... -->
    	<MauiImage Include="Platforms/iOS/Resources/LastMauiImage.png" />
    	<BundleResource Remove="@(MauiImage)" />
    </ItemGroup>
  2. Move the MauiImage items to a different directory (say Platforms/iOS/MauiImages, or Resources/Images).

References:

What's Changed

Read more

.NET 9 - Xcode 16.4 support (9227)

15 Oct 06:49
4681bf9

Choose a tag to compare

Note

Xcode 16.4 is required with this release. Xcode 16.4 requires macOS 15.3+.

This is a servicing release to the previous .NET 9 release.

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

Versions

This release consists of the following versions:

What's Changed

  • [release/9.0.1xx] [system-dependencies] Explicitly install the simulator version we're built for. by @rolfbjarne in #23681
  • [release/9.0.1xx][ci] Use new signing template and fix APIScan by @dalexsoto in #23706
  • [release/9.0.1xx][CI][Tests] Move x64 sonoma tests to the shared pool by @dalexsoto in #23730
  • [release/9.0.1xx] Bring messaging and build agent fixes by @dalexsoto in #23746

Full Changelog: dotnet-9.0.1xx-xcode16.5-9219...dotnet-9.0.1xx-xcode16.5-9227

.NET 10.0.1xx RC 1 (10727)

09 Sep 13:53
fc77072

Choose a tag to compare

Pre-release

We're excited to announce our first release candidate for .NET 10!

Note: these are the base SDKs that add support for the platforms in question. For MAUI (which is built on top of our SDKs), visit: https://learn.microsoft.com/dotnet/maui/.

This release consists of the following versions:

Full release notes: .NET 10 release notes
Known issues: Known issues in .NET 10

Installation

You can use workload set version 10.0.100-rc.1.25458.2 in order to install these versions of the SDKs.

Please make sure to be using the corresponding preview of the .NET SDK 10.0.100 before issuing the dotnet workload install
command below. You can validate your installed dotnet version using dotnet --version do make sure it shows 10.0.100 or greater before proceeding.

dotnet workload install <workload id(s)> --version 10.0.100-rc.1.25458.2

Available workload ids

Example command installing all listed workloads.

dotnet workload install ios tvos macos maccatalyst maui android --version 10.0.100-rc.1.25458.2

You can use dotnet workload --info to validate the workload versions installed in your system.

What's Changed

Preview of Xcode 26 support

This release include preview support for Xcode 26.

To build with support for Xcode 26 and any new API bindings we've implemented so far, append 26.0 to the target framework in the project file. Additionally, ignore a warning about using the Xcode 26.0 preview. Note: .NET 9 must be used, we don't have .NET 10 builds with Xcode 26 support yet.

Example:

<PropertyGroup>
  <TargetFramework>net9.0-ios26.0</TargetFramework>
  <NoWarn>$(NoWarn);XCODE_26_0_PREVIEW</NoWarn>
</PropertyGroup>

This requires installing Xcode 26.0 beta 7.

What's Changed

  • [AppKit] Fix return type for NSStoryboard.InstantiateController / InstantiateInitialController. Fixes #23373. by @rolfbjarne in #23400
  • [bgen] Make BI1075 show which property causes the error. by @rolfbjarne in #23502
  • [bgen] Undo failed docid resolutions from the C# compiler in binding code. by @rolfbjarne in #23560
  • [CoreMedia] Can't inheritdoc from APIs that aren't public. by @rolfbjarne in #23524
  • [dotnet] Add support for the @(LinkerArgument) item group to pass arguments to the native linker. Fixes #21331. by @rolfbjarne in #23468
  • [msbuild] Fix FilterStaticFrameworks task to support custom framework binary names by @Copilot in #23045
  • [net10.0] Update the default value for 'EventSourceSupport' and 'MetricsSupport'. by @rolfbjarne in #23543
  • [runtime] Call mono_jit_cleanup upon exit. by @rolfbjarne in #23446
  • [runtime] Use Mono's v2 GCHandle API. by @rolfbjarne in #23447
  • [src/bgen] Generate xml docs for models if they don't already have docs. by @rolfbjarne in #23459
  • [src/docs] Numerous fixes to the xml docs. by @rolfbjarne in #23531
  • [src] Don't copy xml docs from the declaring type of a method with [DelegateName]. by @rolfbjarne in #23427
  • [src] Don't use for enum fields. by @rolfbjarne in #23526
  • [src] Fix 'cref' elements to be 'see' elements with a 'cref' attribute. by @rolfbjarne in #23565
  • [src] Fix links to images in api xml docs. by @rolfbjarne in #23492
  • [src] Remove redundant generated protocol docs. by @rolfbjarne in #23487
  • [src] Remove some outdated docs about how our event model work. by @rolfbjarne in #23488
  • [VideoSubscriberAccount] Make VSCheckAccessOptionKeys public. by @rolfbjarne in #23493
  • [Windows] _BeforeUnpackLibraryResources - Delete all files in a single run by @emaf in #23441
  • [Windows] Add inputs/outputs to _CreatePkgInfo by @emaf in #23553
  • [Windows] Fix _CompileNativeExecutable inputs/outputs by @emaf in #23533
  • [Windows] Make LinkNativeCode create output file by @emaf in #23534
  • [Windows] Simplify LoadLinkerOutput by @emaf in #23473
  • [Windows] Skip running tasks with no inputs by @emaf in #23458
  • Bump Messaging by @emaf in #23552
  • Bump mlaunch to get a version that works with Xcode 26. by @rolfbjarne in #23499
  • Typo in preview-apis.md by @jfversluis in #23587

Full Changelog: dotnet-10.0.1xx-preview7-10601...dotnet-10.0.1xx-rc.1-10727

.NET 9 - Xcode 16.4 support (9219)

09 Sep 18:56
60f5c7b

Choose a tag to compare

Note

Xcode 16.4 is required with this release. Xcode 16.4 requires macOS 15.3+.

This is a servicing release to the previous .NET 9 release.

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

Versions

This release consists of the following versions:

Installation

You can use workload set version 9.0.305 in order to install these versions of the SDKs.

Please make sure to be using the latest 9.0.305 before issuing the dotnet workload install command below. You can
validate your installed dotnet version using dotnet --version do make sure it shows 9.0.305 or greater before proceeding.

dotnet workload install <workload id(s)> --version 9.0.305

Available workload ids

Example command installing all listed workloads.

dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.305

You can use dotnet workload --info to validate the workload versions installed in your system.

What's Changed

  • [msbuild] Compute DOTNET_DiagnosticPorts using MSBuild properties. by @rolfbjarne in #23629
  • Bump mlaunch to get a version that works with Xcode 26. by @rolfbjarne in #23590

Full Changelog: dotnet-9.0.1xx-xcode16.5-9215...dotnet-9.0.1xx-xcode16.5-9219

.NET 10.0.1xx Preview 7 (10601)

12 Aug 19:24
b770531

Choose a tag to compare

Pre-release

We're excited to announce our seventh preview release for .NET 10!

Note: these are the base SDKs that add support for the platforms in question. For MAUI (which is built on top of our SDKs), visit: https://learn.microsoft.com/dotnet/maui/.

This release consists of the following versions:

Full release notes: .NET 10 release notes
Known issues: Known issues in .NET 10

Installation

You can use workload set version 10.0.100-preview.7.25411.1 in order to install these versions of the SDKs.

Please make sure to be using the corresponding preview of the .NET SDK 10.0.100 before issuing the dotnet workload install
command below. You can validate your installed dotnet version using dotnet --version do make sure it shows 10.0.100 or greater before proceeding.

dotnet workload install <workload id(s)> --version 10.0.100-preview.7.25411.1

Available workload ids

Example command installing all listed workloads.

dotnet workload install ios tvos macos maccatalyst maui android --version 10.0.100-preview.7.25411.1

You can use dotnet workload --info to validate the workload versions installed in your system.

What's Changed

Preview of Xcode 26 support

This release include preview support for Xcode 26.

To build with support for Xcode 26 and any new API bindings we've implemented so far, append 26.0 to the target framework in the project file. Additionally, ignore a warning about using the Xcode 26.0 preview. Note: .NET 9 must be used, we don't have .NET 10 builds with Xcode 26 support yet.

Example:

<PropertyGroup>
  <TargetFramework>net9.0-ios26.0</TargetFramework>
  <NoWarn>$(NoWarn);XCODE_26_0_PREVIEW</NoWarn>
</PropertyGroup>

This requires installing Xcode 26.0 beta 4 (not beta 5, which is the last
available Xcode from Apple at the time of this writing).

What's Changed

Read more

.NET 9 - Xcode 16.4 support (9215)

06 Aug 02:01
8071534

Choose a tag to compare

Note

Xcode 16.4 is required with this release. Xcode 16.4 requires macOS 15.3+.

This is a servicing release to the previous .NET 9 release.

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

Versions

This release consists of the following versions:

Installation

You can use workload set version 9.0.304 in order to install these versions of the SDKs.

Please make sure to be using the latest 9.0.304 before issuing the dotnet workload install command below. You can
validate your installed dotnet version using dotnet --version do make sure it shows 9.0.304 or greater before proceeding.

dotnet workload install <workload id(s)> --version 9.0.304

Available workload ids

Example command installing all listed workloads.

dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.304

You can use dotnet workload --info to validate the workload versions installed in your system.

What's Changed

  • [release/9.0.1xx] [msbuild] Make sure that non-iOS platforms build successfully on non-macOS platforms. Fixes #23101. by @rolfbjarne in #23393

Full Changelog: dotnet-9.0.1xx-xcode16.5-9214...dotnet-9.0.1xx-xcode16.5-9215

.NET 9 - Xcode 16.4 support (9214)

06 Aug 01:26
0e1a194

Choose a tag to compare

Note

Xcode 16.4 is required with this release. Xcode 16.4 requires macOS 15.3+.

This is a servicing release to the previous .NET 9 release.

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

Versions

This release consists of the following versions:

Installation

You can use workload set version 9.0.303.1 in order to install these versions of the SDKs.

Please make sure to be using the latest 9.0.303 before issuing the dotnet workload install command below. You can
validate your installed dotnet version using dotnet --version do make sure it shows 9.0.303 or greater before proceeding.

dotnet workload install <workload id(s)> --version 9.0.303.1

Available workload ids

Example command installing all listed workloads.

dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.303.1

You can use dotnet workload --info to validate the workload versions installed in your system.

What's Changed

Full Changelog: dotnet-9.0.1xx-xcode16.4-9207...dotnet-9.0.1xx-xcode16.5-9214

.NET 9 - Xcode 16.4 support (9207)

09 Jul 06:41
10f1ea3

Choose a tag to compare

Note

Xcode 16.4 is required with this release. Xcode 16.4 requires macOS 15.3+.

This is a servicing release to the previous .NET 9 release.

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

Versions

This release consists of the following versions:

Installation

You can use workload set version 9.0.302.0 in order to install these versions of the SDKs.

Please make sure to be using the latest 9.0.302 before issuing the dotnet workload install command below. You can
validate your installed dotnet version using dotnet --version do make sure it shows 9.0.302 or greater before proceeding.

dotnet workload install <workload id(s)> --version 9.0.302.0

Available workload ids

Example command installing all listed workloads.

dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.302.0

You can use dotnet workload --info to validate the workload versions installed in your system.

What's Changed

Full Changelog: dotnet-9.0.1xx-xcode16.4-9199...dotnet-9.0.1xx-xcode16.4-9207

.NET 10.0.1xx Preview 6 (10451)

15 Jul 23:03
96ea7cf

Choose a tag to compare

Pre-release

We're excited to announce our sixth preview release for .NET 10!

Note: these are the base SDKs that add support for the platforms in question. For MAUI (which is built on top of our SDKs), visit: https://learn.microsoft.com/dotnet/maui/.

This release consists of the following versions:

Full release notes: .NET 10 release notes
Known issues: Known issues in .NET 10

Installation

You can use workload set version 10.0.100-preview.6.25365.1 in order to install these versions of the SDKs.

Please make sure to be using the corresponding preview of the .NET SDK 10.0.100 before issuing the dotnet workload install
command below. You can validate your installed dotnet version using dotnet --version do make sure it shows 10.0.100 or greater before proceeding.

dotnet workload install <workload id(s)> --version 10.0.100-preview.6.25365.1

Available workload ids

Example command installing all listed workloads.

dotnet workload install ios tvos macos maccatalyst maui android --version 10.0.100-preview.6.25365.1

You can use dotnet workload --info to validate the workload versions installed in your system.

What's Changed

Read more