Releases: dotnet/macios
.NET 10 - Xcode 26.2 support (26.2.10191)
Note
- Xcode 26.2 is required with this release. Xcode 26.2 requires macOS 15.6+.
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/.
This release consists of the following versions:
- iOS: 26.2.10191
- tvOS: 26.2.10191
- macOS: 26.2.10191
- Mac Catalyst: 26.2.10191
Installation
You can use workload set version 10.0.101.1 in order to install these versions of the SDKs.
Please make sure to be using the latest .NET SDK 10.0.101 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.101 before proceeding.
dotnet workload install <workload id(s)> --version 10.0.101.1Available workload ids
- ios
- tvos
- macos
- maccatalyst
- android (see https://github.com/dotnet/android)
- maui (see https://github.com/dotnet/maui)
Example command installing all listed workloads.
dotnet workload install ios tvos macos maccatalyst maui android --version 10.0.101.1You can use dotnet workload --info to validate the workload versions installed in your system.
Full release notes: https://github.com/dotnet/macios/wiki/.NET-10-release-notes
What's Changed
- [Foundation] Fix nullability in NSCoder. by @rolfbjarne in #24179
- [src] Fix calling ConformsToProtocol on native instances that don't have a managed peer yet. Fixes #24111. by @rolfbjarne in #24189
- [xcode26.2] Bump to use Xcode 26.2 Beta 1 by @dalexsoto in #24184
- [Foundation] Fix nullability in NSDecimal. by @rolfbjarne in #24187
- [dotnet] Fix loading oldest reference assemblies for library projects. Fixes #24043. by @rolfbjarne in #24181
- [msbuild] Add support for CoreMLCompilerPath to specify the locatio of the 'coremlc' executable. by @rolfbjarne in #24193
- [msbuild] Fix confusion about where the codesign[-bundle].items files are stored. Fixes #24052. by @rolfbjarne in #24198
- [msbuild] Remove outdated Xcode checks by @rolfbjarne in #24188
- [Foundation] Fix nullability in NSDirectoryEnumerator. by @rolfbjarne in #24192
- [dotnet] Adjust the default trimming mode to not trim when using CoreCLR. by @rolfbjarne in #24206
- [tools] Build the partial static registrar for CoreCLR when CoreCLR is enabled. by @rolfbjarne in #24207
- [dotnet] Only do Mono AOT stuff when we're using Mono by @rolfbjarne in #24204
- [runtime] Link with libcoreclr on all platforms when it's enabled there. by @rolfbjarne in #24208
- [src] Make the trimmer inline Runtime.IsCoreCLR correctly for iOS, tvOS and Mac Catalyst by @rolfbjarne in #24205
- [msbuild] Add support for CopySceneKitAssetsPath to specify the location of the 'copySceneKitAssets' executable. by @rolfbjarne in #24218
- [src] Remove 'remarks' nodes from enum fields, and add a test. by @rolfbjarne in #24232
- [docs] Update docs about how to update API docs with one last step. by @rolfbjarne in #24233
- [xcode26.1.1] Bump to Xcode 26.1.1 by @rolfbjarne in #24231
- [docs] Update docs to match the published version. by @rolfbjarne in #24227
- [apiref] Bump to latest stable published NuGet packages by @dalexsoto in #24235
- [xcode26.2] Merge main into xcode26.2 by @dalexsoto in #24238
- [system-dependencies] Make simulator runtime installation a bit more resilient. by @rolfbjarne in #24243
- [msbuild] Always run WriteItemsFromFile locally. by @rolfbjarne in #24211
- [docs] Use absolute link to update-api-docs.md in the release check list. by @rolfbjarne in #24234
- [Foundation] Fix nullability in NSError. by @rolfbjarne in #24242
- [msbuild] Remove reference to System.Collections.Immutable. by @rolfbjarne in #24237
- [devops] Disable AzDO dependabot by @mmitche in #24255
- [introspection] Tweak which assemblies ApiPInvokeTest tests. by @rolfbjarne in #24252
- [Foundation] Fix nullability in NSFastEnumerator. by @rolfbjarne in #24253
- [Foundation] Fix nullability in NSItemProvider. by @rolfbjarne in #24258
- [Foundation] Fix nullability in NSUrlRequest. by @rolfbjarne in #24263
- [Foundation] Fix nullability in NSXpcInterface. by @rolfbjarne in #24264
- [Foundation] Fix nullability in NSValue. by @rolfbjarne in #24265
- [src] Add a [DynamicDependency] attribute from the event field to exported method for generated events. Fixes #24262. by @rolfbjarne in #24270
- [xcode26.2] Update AuthenticationServices to Xcode 26.2 Beta 1 by @dalexsoto in #24284
- [xcode26.2] Update to Xcode 26.2 Beta 2 by @dalexsoto in #24289
- [xcode26.2] Update AVFoundation bindings to Xcode 26.2 Beta 1 by @dalexsoto in #24285
- [Foundation] Fix nullability in NSUrlCredential. by @rolfbjarne in #24277
- [mlaunch] Update mlaunch to 1.1.93 by @mauroa in #24257
- [Foundation] Fix nullability in NSXpcConnection. by @rolfbjarne in #24268
- [Network] Fix NWBrowseResult.TxtRecord to not throw an exception if there's no TxtRecord. by @rolfbjarne in #24295
- [xcode26.2] Update GameKit bindings to Xcode 26.2 Beta 2 by @dalexsoto in #24302
- [Foundation] Fix nullability in NSUrlDownload. by @rolfbjarne in #24275
- [Foundation] Fix nullability in NSUrlProtectionSpace. by @rolfbjarne in #24271
- [xcode26.2] Update BrowserEngineKit bindings to Xcode 26.2 Beta 1 by @dalexsoto in #24287
- [Foundation] Fix nullability in NSTimeZone. by @rolfbjarne in #24304
- [xcode26.2] Update GameController bindings to Xcode 26.2 Beta 2 by @dalexsoto in #24297
- [xcode26.2] Update HealthKit bindings to Xcode 26.2 Beta 2 by @dalexsoto in #24307
- [Foundation] Fix nullability in NSUbiquitousKeyValueStore. by @rolfbjarne in #24278
- [Foundation] Document NSUrlSessionHandler.MaxInputInMemory. Fixes #21537. by @rolfbjarne in #24305
- [xcode26.2] Update PassKit bindings to Xcode 26.2 Beta 2 by @dalexsoto in #24310
- [Foundation] Fix nullability in NSUrlSession. by @rolfbjarne in #24269
- [xcode26.2] Merge main into xcode26.2 by @dalexsoto in #24318
- [xcode26.2] Update SafariServices bindings to Xcode 26.2 Beta 2 by @dalexsoto in #24320
- [xcode26.2] Update Security bindings to Xcode 26.2 Beta 2 by @dalexsoto in #24321
- [msbuild] Fix XcodeProject output path when using artifacts folder by @Copilot in #24224
- [tools] Mark the Invoke methods for the type to create block proxies when using the static registrar. by @rolfbjarne in #24344
- [Foundation] Fix nullability in NSStream. by @rolfbjarne in #24308
- [xcode26.2] Bump to Xcode 26.2 Release Candidate by @dalexsoto in #24359
- [xcode26.2] Merge main into xcode26.2 by @dalexsoto in #24357
- [Foundation] Improve documentation and remove redundant platform attributes in NSOrderedSet. by @rolfbjarne in #24345
- [Foundation] Fix nullability in NSRange. by @rolfbjarne in #24356
- [CoreAnimation] Remove incorrect availability attributes from CASpringAnimation.SettlingDuration by @Copilot in #24341
- [Foundation] Fix nullability in NSScriptCommandDescription. by @rolfbjarne in #24351
- ...
.NET 9 - Xcode 26.0 support (9783)
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.
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.308.2 in order to install these versions of the SDKs.
Please make sure to be using the latest .NET SDK 9.0.308 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.308 or greater before proceeding.
dotnet workload install <workload id(s)> --version 9.0.308.2Available workload ids
- ios
- tvos
- macos
- maccatalyst
- android (see https://github.com/dotnet/android)
- maui (see https://github.com/dotnet/maui)
Example command installing all listed workloads.
dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.308.2You can use dotnet workload --info to validate the workload versions installed in your system.
What's Changed
- [release/9.0.1xx] Update mlaunch to 1.1.93 by @rolfbjarne in #24366
Full Changelog: dotnet-9.0.1xx-xcode26.0-9777...dotnet-9.0.1xx-xcode26.0-9783
.NET 10 - Xcode 26.1 support (26.1.10502)
Note
- Xcode 26.1 is required with this release. Xcode 26.1 requires macOS 15.6+.
- This workload is included in Visual Studio 2026 (v18.1)
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/.
This release consists of the following versions:
- iOS: 26.1.10502
- tvOS: 26.1.10502
- macOS: 26.1.10502
- Mac Catalyst: 26.1.10502
Installation
You can use workload set version 10.0.101 in order to install these versions of the SDKs.
Please make sure to be using the latest .NET SDK 10.0.101 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.101 before proceeding.
dotnet workload install <workload id(s)> --version 10.0.101Available workload ids
- ios
- tvos
- macos
- maccatalyst
- android (see https://github.com/dotnet/android)
- maui (see https://github.com/dotnet/maui)
Example command installing all listed workloads.
dotnet workload install ios tvos macos maccatalyst maui android --version 10.0.101You can use dotnet workload --info to validate the workload versions installed in your system.
Full release notes: https://github.com/dotnet/macios/wiki/.NET-10-release-notes
What's Changed
- [release/10.0.1xx] [src] Add a [DynamicDependency] attribute from the event field to exported method for generated events. Fixes #24262. by @rolfbjarne in #24288
Full Changelog: dotnet-10.0.1xx-xcode26.1-10494...dotnet-10.0.1xx-xcode26.1-10502
.NET 9 - Xcode 26.0 support (9777)
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.
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.308.1 in order to install these versions of the SDKs.
Please make sure to be using the latest .NET SDK 9.0.308 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.308 or greater before proceeding.
dotnet workload install <workload id(s)> --version 9.0.308.1Available workload ids
- ios
- tvos
- macos
- maccatalyst
- android (see https://github.com/dotnet/android)
- maui (see https://github.com/dotnet/maui)
Example command installing all listed workloads.
dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.308.1You can use dotnet workload --info to validate the workload versions installed in your system.
What's Changed
Full Changelog: dotnet-9.0.1xx-xcode26.0-9769...dotnet-9.0.1xx-xcode26.0-9777
.NET 10 - Xcode 26.1 support (26.1.10494)
Note
- Xcode 26.1 is required with this release. Xcode 26.1 requires macOS 15.6+.
- This workload is included in Visual Studio 2026 (v18.0.1)
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/.
This release consists of the following versions:
- iOS: 26.1.10494
- tvOS: 26.1.10494
- macOS: 26.1.10494
- Mac Catalyst: 26.1.10494
Installation
You can use workload set version 10.0.100.1 in order to install these versions of the SDKs.
Please make sure to be using the latest .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 before proceeding.
dotnet workload install <workload id(s)> --version 10.0.100.1Available workload ids
- ios
- tvos
- macos
- maccatalyst
- android (see https://github.com/dotnet/android)
- maui (see https://github.com/dotnet/maui)
Example command installing all listed workloads.
dotnet workload install ios tvos macos maccatalyst maui android --version 10.0.100.1You can use dotnet workload --info to validate the workload versions installed in your system.
Full release notes: https://github.com/dotnet/macios/wiki/.NET-10-release-notes
What's Changed
- [LocalAuthentication] Fix nullability for LAContext.CanEvaluatePolicy. Fixes #12981. by @rolfbjarne in #23911
- [UIKit] Add a weakly typed UIMenu.Identifier property and UIMenu.Create overload. Fixes #14177. by @rolfbjarne in #23913
- [AVFoundation] Improve documentation for AVFileTypes.Mpeg3. Fixes #8735. by @rolfbjarne in #23908
- [WebKit] Improve documentation for WKHttpCookieStore.[Add|Remove]Observer. Fixes #9984. by @rolfbjarne in #23910
- [xcode26.1] Bump to Xcode 26.1 Beta 1 by @dalexsoto in #23873
- [main] Update dependencies from dotnet/arcade by @dotnet-maestro[bot] in #23934
- [UIKit] Fix incorrect property type for UIButtonConfiguration.SymbolContentTransition. Fixes #23925. by @rolfbjarne in #23930
- [Foundation] Fix the property type for NSUrlAuthenticationChallenge.Sender. Fixes #7333. by @rolfbjarne in #23906
- [tools] ShazamKit is now available in the simulator. Fixes #15138. by @rolfbjarne in #23921
- [xcode26.1] Update AVFoundation to beta 1. by @rolfbjarne in #23899
- [xcode26.1] Update CarPlay to beta 1. by @rolfbjarne in #23880
- [xcode26.1] Update AuthenticationServices to beta 1. by @rolfbjarne in #23904
- [xcode26.1] Update AccessorySetupKit to beta 1. by @rolfbjarne in #23897
- [xcode26.1] Update Metal to beta 1. by @rolfbjarne in #23901
- [xcode26.1] Update UIKit to beta 1. by @rolfbjarne in #23887
- [xcode26.1] Update AutomaticAssessmentConfiguration to beta 1. by @rolfbjarne in #23878
- [xcode26.1] Update HomeKit to beta 1. by @rolfbjarne in #23884
- [xcode26.1] Update CallKit to beta 1. by @rolfbjarne in #23902
- [bgen] Fix APIs with both [Protected] and [Internal]. Fixes #6889. by @rolfbjarne in #23937
- [bgen] Handle [DesignatedInitializer] being in two places at once. Fixes #10106. by @rolfbjarne in #23940
- [CoreAnimation] Improve docs for CALayer.[Set|Get]Contents. Fixes #23933. by @rolfbjarne in #23943
- [NetworkExtension] Fix nullability for NETunnelProvider.HandleAppMessage. Fixes #16789. by @rolfbjarne in #23948
- [AppKit] Bind the NSBindingOption constants as a strong dictionary. Fixes #17983. by @rolfbjarne in #23954
- [Foundation] Update bindings for NSCoder. Fixes #4471. by @rolfbjarne in #23945
- [CoreFoundation] Improve the handling of data callbacks in CFSocket.OnCallback. by @rolfbjarne in #23955
- [CoreFoundation] Generate any CFProxy keys. Fixes #18911. by @rolfbjarne in #23956
- [xcode26.1] Bump to beta 2. by @rolfbjarne in #23959
- [runtime] The 'libextension-dotnet.a' library is required for tvOS. Fixes #13260. by @rolfbjarne in #23957
- [bgen] Warn with [Protocol]+[BaseType], but no [Model]. Fixes #17286. by @rolfbjarne in #23949
- [msbuild] Ensure all resources are available on Windows before packing them. Fixes #23928. by @rolfbjarne in #23971
- [msbuild] Unify and improve code to execute tasks remotely. Fixes #23927. by @rolfbjarne in #23944
- [devops] Make the test filter configurable when running remote tests. by @rolfbjarne in #23970
- [AVFoundation] Add a strongly typed AVAssetWriter factory method. Fixes #21509. by @rolfbjarne in #23982
- [CoreGraphics] Implement getting the refresh rate for a CGDisplay. Fixes #9958. by @rolfbjarne in #23922
- [main] Update dependencies from dotnet/sdk by @dotnet-maestro[bot] in #23974
- [msbuild] Use TaskRunner.CopyInputsAsync2 to copy inputs to the remote build server. by @rolfbjarne in #23965
- [dotnet] Don't overwrite any existing value for DOTNET_DiagnosticPorts when computed through our build logic. by @rolfbjarne in #23993
- [Photos] Bump to Xcode 26.1 Beta 2. by @rolfbjarne in #24001
- [msbuild] Renumber msbuild error codes to avoid duplicating them. by @rolfbjarne in #24012
- [UIKit] Update to Xcode 26.1 beta 2. by @rolfbjarne in #24013
- Use 'global using' statements in most projects to simplify code. by @rolfbjarne in #23895
- [CoreGraphics] Update to Xcode 26.1 beta 2. by @rolfbjarne in #24000
- [HomeKit] Update to Xcode 26.1 beta 2. by @rolfbjarne in #24009
- [AudioToolbox] Improve AudioQueue API a little bit. Fixes #11183. by @rolfbjarne in #23988
- [Foundation] Update to Xcode 26.1 beta 2. by @rolfbjarne in #24016
- [CoreMedia] Improve CMFormatDescription.SubType properties. Fixes #23217. by @rolfbjarne in #23262
- Bump mlaunch. by @rolfbjarne in #24040
- [CoreImage] Adjust a little bit how filters are bound and verified. by @rolfbjarne in #23987
- [xcode26.1] Bump to Xcode 26.1 Beta 3 by @dalexsoto in #24051
- [Foundation] Improve cookie storage a bit in NSUrlSessionHandler. Fixes #23950. by @rolfbjarne in #24058
- [tests] Add a test to verify and keep track of app size changes. by @rolfbjarne in #23999
- [introspection] Apple fixed FB18122430 in Xcode 26.1. by @rolfbjarne in #24070
- [msbuild] Fix DetectSigningIdentity with entitlements in the simulator. Fixes #24032. by @rolfbjarne in #24076
- [runtime] Adopt safer native compiler flags: Wignored-qualifiers by @rolfbjarne in #24068
- [Accessibility] Update bindings to Xcode 26.1 Beta 3 by @dalexsoto in #24060
- [runtime] Adopt safer native compiler flags: Wmissing-field-initializers by @rolfbjarne in #24071
- [runtime] Retry downloading coreclrhost.h if it fails. by @rolfbjarne in #24069
- [AppKit] Update bindings to Xcode 26.1 Beta 3 by @dalexsoto in #24080
- [build] Make it possible to select to build for either the simulator or device. by @rolfbjarne in #24092
- [runtime] Adopt safer native compiler flags: Wcast-function-type-mismatch by @rolfbjarne in #24083
- [runtime] Adopt safer native compiler flags: Wsemicolon-before-method-body by @rolfbjarne in #24078
- [runtime] Adopt safer native compiler flags: Wsign-co...
.NET 9 - Xcode 26.0 support (9769)
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.
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.307.1 in order to install these versions of the SDKs.
Please make sure to be using the latest .NET SDK 9.0.307 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.307 or greater before proceeding.
dotnet workload install <workload id(s)> --version 9.0.307.1Available workload ids
- ios
- tvos
- macos
- maccatalyst
- android (see https://github.com/dotnet/android)
- maui (see https://github.com/dotnet/maui)
Example command installing all listed workloads.
dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.307.1You can use dotnet workload --info to validate the workload versions installed in your system.
What's Changed
- [src] Fix calling ConformsToProtocol on native instances that don't have a managed peer yet. Fixes #24111. by @rolfbjarne in #24191
- [msbuild] Fix confusion about where the codesign[-bundle].items files are stored. Fixes #24052. by @dalexsoto in #24200
Full Changelog: dotnet-9.0.1xx-xcode26.0-9766...dotnet-9.0.1xx-xcode26.0-9769
.NET 9 - Xcode 26.0 support (9766)
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.
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.307 in order to install these versions of the SDKs.
Please make sure to be using the latest .NET SDK 9.0.307 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.307 or greater before proceeding.
dotnet workload install <workload id(s)> --version 9.0.307Available workload ids
- ios
- tvos
- macos
- maccatalyst
- android (see https://github.com/dotnet/android)
- maui (see https://github.com/dotnet/maui)
Example command installing all listed workloads.
dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.307You can use dotnet workload --info to validate the workload versions installed in your system.
What's Changed
- [dotnet] Don't overwrite any existing value for DOTNET_DiagnosticPorts when computed through our build logic. by @rolfbjarne in #23998
- [msbuild] Fix DetectSigningIdentity with entitlements in the simulator. Fixes #24032. by @rolfbjarne in #24059
- Bump mlaunch to get improved launch failure message. Fixes #23923. by @rolfbjarne in #24102
- Revert "[dotnet] Remove support for .NET 8." Fixes #24057. by @rolfbjarne in #24049
Full Changelog: dotnet-9.0.1xx-xcode26.0-9752...dotnet-9.0.1xx-xcode26.0-9766
.NET 10 - Xcode 26.0 support (26.0.11017)
We're excited to announce our .NET 10 SDK release!
Note
- Xcode 26.0 is required with this release. Xcode 26.0 requires macOS 15.6+.
- This version is included in Visual Studio 2026.
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/.
This release consists of the following versions:
- iOS: 26.0.11017
- tvOS: 26.0.11017
- macOS: 26.0.11017
- Mac Catalyst: 26.0.11017
Installation
You can use workload set version 10.0.100 in order to install these versions of the SDKs.
Please make sure to be using the latest .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 before proceeding.
dotnet workload install <workload id(s)> --version 10.0.100Available workload ids
- ios
- tvos
- macos
- maccatalyst
- android (see https://github.com/dotnet/android)
- maui (see https://github.com/dotnet/maui)
Example command installing all listed workloads.
dotnet workload install ios tvos macos maccatalyst maui android --version 10.0.100You can use dotnet workload --info to validate the workload versions installed in your system.
Full release notes: https://github.com/dotnet/macios/wiki/.NET-10-release-notes
What's Changed
- [docs] Document the SkipCodesignItems item group. Fixes #23847. by @rolfbjarne in #23879
- [dotnet] Add a way to get help with how apps are launched on mobile. by @rolfbjarne in #22858
- [dotnet] Add Xcode 26.0 packages for .NET 10. by @rolfbjarne in #23715
- [dotnet] Disable aggressive attribute trimming when using NativeAOT. Fixes #22065. by @rolfbjarne in #22151
- [dotnet] Disable metrics support by default for non-Release builds by @rolfbjarne in #22389
- [dotnet] Disable Metrics support when Optimize=true. by @rolfbjarne in #22449
- [dotnet] Don't overwrite any existing value for DOTNET_DiagnosticPorts when computed through our build logic. by @rolfbjarne in #23997
- [dotnet] Fix default target platform version for libraries for .NET 9. by @rolfbjarne in #23870
- [dotnet] Pass --preserve-symbol-paths to the trimmer to ensure trimmed assemblies aren't different between architectures. by @rolfbjarne in #23858
- [dotnet] Remove support for .NET 8. by @rolfbjarne in #23869
- [dotnet] Rework aggressive attribute trimming. Fixes #20906. by @rolfbjarne in #21314
- [dotnet] Stop suppressing trim analysis warnings. Fixes #21293. by @rolfbjarne in #21351
- [dotnet] Use the 'ComputeRunArguments' target to compute properties for 'dotnet run'. by @rolfbjarne in #22816
- [hotrestart] Remove Hot Restart from the iOS SDK by @mauroa in #23815
- [msbuild] Fix DetectSigningIdentity with entitlements in the simulator. Fixes #24032. by @rolfbjarne in #24077
- [msbuild] Fix PartialAppManifests from library projects with incremental builds. by @rolfbjarne in #23865
- [msbuild] Improve detection of resources that would end up outside the app bundle. by @rolfbjarne in #23919
- [msbuild] introduce
_CompileAppManifestInputsby @jonathanpeppers in #22745 - [msbuild] Only decompress binding resource packages remotely. Fixes #23346. by @rolfbjarne in #23859
- [runtime/src] Raise the AppDomain.UnhandledException event on CoreCLR. Fixes #15252. by @rolfbjarne in #22778
- [src] Add MetalFX to tvOS and Mac Catalyst. by @rolfbjarne in #23877
- [UIKit] Fix a GC race in UIBarButtonItem. by @rolfbjarne in #21572
- [xcode26.0] Bump to Xcode 26.0.1 stable version by @dalexsoto in #23871
- Add Xcode 26.0 preview builds. by @rolfbjarne in #23171
- Drop .NET 8 support. by @rolfbjarne in #22549
- Misc updates to .NET 8 -> .NET 11. by @rolfbjarne in #23866
- Trim by default (SdkOnly) when building for arm64. Fixes #21444. by @rolfbjarne in #21461
- Update coreclrhost.h download URL by @ivanpovazan in #22213
- Update the default value for 'EventSourceSupport' and 'MetricsSupport'. by @rolfbjarne in #23543
Full Changelog: dotnet-9.0.1xx-xcode26.0-9766...dotnet-10.0.1xx-xcode26.0-11017
.NET 10.0.1xx RC 2 (10970)
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:
- iOS: 26.0.10970-net10-rc.2
- tvOS: 26.0.10970-net10-rc.2
- Mac Catalyst: 26.0.10970-net10-rc.2
- macOS: 26.0.10970-net10-rc.2
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.4Available workload ids
- ios
- tvos
- macos
- maccatalyst
- android (see https://github.com/dotnet/android)
- maui (see https://github.com/dotnet/maui)
Example command installing all listed workloads.
dotnet workload install ios tvos macos maccatalyst maui android --version 10.0.100-rc.2.25513.4You 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
- [Accessibility] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23480
- [AccessorySetupKit] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23528
- [AppKit] NSApplication.ApplicationShouldSuppressHighDynamicRangeContent is readonly. by @rolfbjarne in #23415
- [AppKit] Update bindings to Xcode 26.0 Beta 5 by @dalexsoto in #23539
- [ARKit] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23687
- [AudioToolbox] Improve AudioFile API a little bit. by @rolfbjarne in #23745
- [AudioUnit] Fix typo: AudioUnitSubType.Revert2 -> AudioUnitSubType.Reverb2. by @rolfbjarne in #23414
- [AuthenticationServices] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23529
- [AutomaticAssessmentConfiguration] Update bindings to Xcode 26 beta 3. by @rolfbjarne in #23371
- [AVFoundation] Update bindings to Xcode 26 beta 1-6. by @rolfbjarne in #23437
- [AVKit] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23541
- [AVRouting] Update bindings to Xcode 26 beta 1-5. by @rolfbjarne in #23436
- [BackgroundTasks] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23700
- [bgen] Add iOSAttribute and MacAttribute to the binding attributes. by @rolfbjarne in #23806
- [BrowserEngineCore] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23659
- [BrowserEngineKit] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23570
- [CAAnimation/QuartzCore] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23697
- [CallKit] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23546
- [CarPlay] Update bindings to Xcode 26 Beta 1 - 5 by @dalexsoto in #23536
- [Cinematic] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23561
- [CloudKit] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23582
- [CoreAudio] Don't bind this framework. by @rolfbjarne in #23695
- [CoreFoundation] Update to Xcode 26 beta 1-4. by @rolfbjarne in #23469
- [CoreGraphics] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23652
- [CoreImage] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23702
- [CoreLocation] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23547
- [CoreMedia] Update to Xcode 26 beta 1-7. by @rolfbjarne in #23733
- [CoreNFC] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23481
- [CoreTelephony] Adjust availability of CTCellularPlanProvisioning.AddPlan for Mac Catalyst. by @rolfbjarne in #23383
- [CoreTelephony] Update bindings to Xcode 26 beta 1-3. by @rolfbjarne in #23295
- [CoreVideo] Update to Xcode 26 beta 1-7. by @rolfbjarne in #23734
- [DeviceDiscoveryExtension] Update bindings to Xcode 26 beta 1-4. by @rolfbjarne in #23420
- [DeviceDiscoveryUI] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23482
- [docs] Document BundleCreateDump. by @rolfbjarne in #23854
- [dotnet] Add Xcode 26.0 packages for .NET 10. by @rolfbjarne in #23715
- [ExtensionKit] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23483
- [FileProvider] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23567
- [Foundation] Avoid calling ToString more than once on headers and their values. by @rolfbjarne in #23825
- [Foundation] Fix a few of NSAttributedString's Create methods to return null in case of failure. Fixes #23584. by @rolfbjarne in #23600
- [Foundation] Make it possible to customize the X509ChainPolicy when validating certificates in NSUrlSessionHandler. Fixes #23764. by @rolfbjarne in #23767
- [Foundation] Update bindings to Xcode 26 beta 1-4. by @rolfbjarne in #23421
- [FSKit] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23562
- [GameController] Update bindings to Xcode 26.0 Beta 1 - 4 by @dalexsoto in #23476
- [GameKit] Update bindings to Xcode 26 Beta 1 to 4 by @dalexsoto in #23474
- [GameSave] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23563
- [HealthKit] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23696
- [ImageIO] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23484
- [LocalAuthentication] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23564
- [MapKit] Update bindings to Xcode 26 beta 1-3. by @rolfbjarne in #23308
- [MediaAccessibility] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23588
- [MediaExtension] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23699
- [MediaPlayer] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23457
- [Messages] Update to Xcode 26 beta 2-4. by @rolfbjarne in #23470
- [messaging] Fixed environment variables logic on Build Agent by @mauroa in #23676
- [Metal] Update to Xcode 26 beta 5. by @rolfbjarne in #23549
- [MetalFX] Update bindings to Xcode 26 beta 1-7. by @rolfbjarne in #23426
- [MetalPerformanceShaders] Bind missing APIs. by @rolfbjarne in #23785
- [MetalPerformanceShadersGraph] Update bindings to Xcode 26 beta 1-5. by @rolfbjarne in #23417
- [MetricKit] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23703
- [msbuild/dotnet] Add support for 'MonoUseCompressedInterfaceBitmap' to enable compressed interface bitmaps. by @rolfbjarne in #23834
- [msbuild] Compute DOTNET_DiagnosticPorts using MSBuild properties. by @rolfbjarne in #23429
- [msbuild] Fix parsing bundler verbosity. by @rolfbjarne in #23845
- [msbuild] Fix PartialAppManifests from library projects with incremental builds. by @rolfbjarne in #23865
- [msbuild] The App Groups entitlement is available on all platforms. by @rolfbjarne in #23841
- [NearbyInteraction] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23586
- [Network] Update to Xcode 26...
.NET 9 - Xcode 26.0 support (9752)
Note
- Xcode 26.0 is required with this release. Xcode 26.0 requires macOS 15.6+.
- This version is included in Visual Studio 17.14.17.
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.306Available workload ids
- ios
- tvos
- macos
- maccatalyst
- android (see https://github.com/dotnet/android)
- maui (see https://github.com/dotnet/maui)
Example command installing all listed workloads.
dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.306You 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
MauiImageitems 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)
MauiImageitems, and add those resized images to the build.
There are multiple ways to fix this, here are a few:
-
Remove all
MauiImagefrom theBundleResourceitem group (where they were added by default):<ItemGroup> <!-- ... --> <MauiImage Include="Platforms/iOS/Resources/LastMauiImage.png" /> <BundleResource Remove="@(MauiImage)" /> </ItemGroup>
-
Move the
MauiImageitems to a different directory (sayPlatforms/iOS/MauiImages, orResources/Images).
References:
- #19029
- https://github.com/dotnet/macios/issues/24014
- https://github.com/dotnet/macios/blob/main/dotnet/DefaultCompilationIncludes.md
What's Changed
- .NET: Add AppBundleResourcePrefix property to unify resource prefix properties by @Copilot in #22840
- [Accessibility] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23480
- [AccessorySetupKit] Introduce a default ctor for a few classes. by @rolfbjarne in #23040
- [AccessorySetupKit] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23528
- [Accounts] Fix Action based delegate signatures. by @mandel-macaque in #23244
- [Accounts] Fix nullability on delegates. by @mandel-macaque in #23063
- [AppClip] Fix Action based delegate signatures. by @mandel-macaque in #23245
- [AppKit] Fix Action based delegate signatures. by @mandel-macaque in #23246
- [AppKit] Fix return type for NSStoryboard.InstantiateController / InstantiateInitialController. Fixes #23373. by @rolfbjarne in #23400
- [AppKit] NSApplication.ApplicationShouldSuppressHighDynamicRangeContent is readonly. by @rolfbjarne in #23415
- [AppKit] Update bindings to Xcode 26.0 Beta 5 by @dalexsoto in #23539
- [ArKit] Fix managed delegate signatures. by @mandel-macaque in #23230
- [ARKit] Fix nullability in delegate signatures. by @mandel-macaque in #23061
- [ARKit] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23687
- [AudioToolbox] Improve AudioFile API a little bit. by @rolfbjarne in #23745
- [AudioUnit] Fix typo: AudioUnitSubType.Revert2 -> AudioUnitSubType.Reverb2. by @rolfbjarne in #23414
- [AuthenticationServices] Fix nullability in the delegates. by @mandel-macaque in #23080
- [AuthenticationServices] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23529
- [AutomaticAssessmentConfiguration] Update bindings to Xcode 26 beta 3. by @rolfbjarne in #23371
- [AVFoundation] Fix enum value for AVAssetExportSessionPreset to be in the right location. Fixes #23267. by @rolfbjarne in #23268
- [AVFoundation] Fix nullability in some delegate signatures. by @mandel-macaque in #23062
- [AVFoundation] Update bindings to Xcode 26 beta 1-6. by @rolfbjarne in #23437
- [AVKit] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23541
- [AVRouting] Update bindings to Xcode 26 beta 1-5. by @rolfbjarne in #23436
- [BackgroundTasks] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23700
- [bgen] Add iOSAttribute and MacAttribute to the binding attributes. by @rolfbjarne in #23806
- [bgen] Fix strong enums with value type backing fields. by @rolfbjarne in #23077
- [bgen] Improve the BI1078 error message to include the type name. by @rolfbjarne in #23349
- [bgen] Make BI1075 show which property causes the error. by @rolfbjarne in #23502
- [bgen] Stop fail-fast on exceptions, and instead keep going, trying to report as many as possible. by @rolfbjarne in #23258
- [bgen] Undo failed docid resolutions from the C# compiler in binding code. by @rolfbjarne in #23560
- [BrowserEngineCore] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23659
- [BrowserEngineKit] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23570
- [CAAnimation/QuartzCore] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23697
- [CallKit] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23546
- [CarPlay] Update bindings to Xcode 26 Beta 1 - 5 by @dalexsoto in #23536
- [Cinematic] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23561
- [ClockKit] Remove this framework, it's a watchOS-only framework. by @rolfbjarne in #23157
- [CloudKit] Fix all the delegate signatures. by @mandel-macaque in #23090
- [CloudKit] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23582
- [Contacts] Fix delegate signatures. by @mandel-macaque in #23092
- [CoreAudio] Don't bind this framework. by @rolfbjarne in #23695
- [CoreData] Fix delegate signatures. by @mandel-macaque in #23135
- [CoreFoundation] Update to Xcode 26 beta 1-4. by @rolfbjarne in #23469
- [CoreGraphics] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23652
- [CoreImage] Generate the CIFormat convenience enum. Fixes #23056. by @rolfbjarne in #23156
- [CoreImage] Update to Xcode 26 beta 1-6. by @rolfbjarne in #23702
- [CoreLocation] Fix delegate signatures. by @mandel-macaque in #23137
- [CoreLocation] Make CLLocationManager.IsMonitoringAvailable(Type) available on macOS. by @rolfbjarne in #23356
- [CoreLocation] Update to Xcode 26 beta 1-5. by @rolfbjarne in #23547
- [CoreMedia] Bind CMFormatDescriptionExtensions and related APIs. Fixes #23239. by @rolfbjarne in https://github.com/dotnet/macio...