Xamarin.iOS & Xamarin.Mac Files

[!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.

:::sh
dotnet workload install <workload id(s)> --version 10.0.101.1

Available 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.

:::sh
dotnet workload install ios tvos macos maccatalyst maui android --version 10.0.101.1

You 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 https://github.com/dotnet/macios/pull/24179
• [src] Fix calling ConformsToProtocol on native instances that don't have a managed peer yet. Fixes [#24111]. by @rolfbjarne in https://github.com/dotnet/macios/pull/24189
• [xcode26.2] Bump to use Xcode 26.2 Beta 1 by @dalexsoto in https://github.com/dotnet/macios/pull/24184
• [Foundation] Fix nullability in NSDecimal. by @rolfbjarne in https://github.com/dotnet/macios/pull/24187
• [dotnet] Fix loading oldest reference assemblies for library projects. Fixes [#24043]. by @rolfbjarne in https://github.com/dotnet/macios/pull/24181
• [msbuild] Add support for CoreMLCompilerPath to specify the locatio of the 'coremlc' executable. by @rolfbjarne in https://github.com/dotnet/macios/pull/24193
• [msbuild] Fix confusion about where the codesign[-bundle].items files are stored. Fixes [#24052]. by @rolfbjarne in https://github.com/dotnet/macios/pull/24198
• [msbuild] Remove outdated Xcode checks by @rolfbjarne in https://github.com/dotnet/macios/pull/24188
• [Foundation] Fix nullability in NSDirectoryEnumerator. by @rolfbjarne in https://github.com/dotnet/macios/pull/24192
• [dotnet] Adjust the default trimming mode to not trim when using CoreCLR. by @rolfbjarne in https://github.com/dotnet/macios/pull/24206
• [tools] Build the partial static registrar for CoreCLR when CoreCLR is enabled. by @rolfbjarne in https://github.com/dotnet/macios/pull/24207
• [dotnet] Only do Mono AOT stuff when we're using Mono by @rolfbjarne in https://github.com/dotnet/macios/pull/24204
• [runtime] Link with libcoreclr on all platforms when it's enabled there. by @rolfbjarne in https://github.com/dotnet/macios/pull/24208
• [src] Make the trimmer inline Runtime.IsCoreCLR correctly for iOS, tvOS and Mac Catalyst by @rolfbjarne in https://github.com/dotnet/macios/pull/24205
• [msbuild] Add support for CopySceneKitAssetsPath to specify the location of the 'copySceneKitAssets' executable. by @rolfbjarne in https://github.com/dotnet/macios/pull/24218
• [src] Remove 'remarks' nodes from enum fields, and add a test. by @rolfbjarne in https://github.com/dotnet/macios/pull/24232
• [docs] Update docs about how to update API docs with one last step. by @rolfbjarne in https://github.com/dotnet/macios/pull/24233
• [xcode26.1.1] Bump to Xcode 26.1.1 by @rolfbjarne in https://github.com/dotnet/macios/pull/24231
• [docs] Update docs to match the published version. by @rolfbjarne in https://github.com/dotnet/macios/pull/24227
• [apiref] Bump to latest stable published NuGet packages by @dalexsoto in https://github.com/dotnet/macios/pull/24235
• [xcode26.2] Merge main into xcode26.2 by @dalexsoto in https://github.com/dotnet/macios/pull/24238
• [system-dependencies] Make simulator runtime installation a bit more resilient. by @rolfbjarne in https://github.com/dotnet/macios/pull/24243
• [msbuild] Always run WriteItemsFromFile locally. by @rolfbjarne in https://github.com/dotnet/macios/pull/24211
• [docs] Use absolute link to update-api-docs.md in the release check list. by @rolfbjarne in https://github.com/dotnet/macios/pull/24234
• [Foundation] Fix nullability in NSError. by @rolfbjarne in https://github.com/dotnet/macios/pull/24242
• [msbuild] Remove reference to System.Collections.Immutable. by @rolfbjarne in https://github.com/dotnet/macios/pull/24237
• [devops] Disable AzDO dependabot by @mmitche in https://github.com/dotnet/macios/pull/24255
• [introspection] Tweak which assemblies ApiPInvokeTest tests. by @rolfbjarne in https://github.com/dotnet/macios/pull/24252
• [Foundation] Fix nullability in NSFastEnumerator. by @rolfbjarne in https://github.com/dotnet/macios/pull/24253
• [Foundation] Fix nullability in NSItemProvider. by @rolfbjarne in https://github.com/dotnet/macios/pull/24258
• [Foundation] Fix nullability in NSUrlRequest. by @rolfbjarne in https://github.com/dotnet/macios/pull/24263
• [Foundation] Fix nullability in NSXpcInterface. by @rolfbjarne in https://github.com/dotnet/macios/pull/24264
• [Foundation] Fix nullability in NSValue. by @rolfbjarne in https://github.com/dotnet/macios/pull/24265
• [src] Add a [DynamicDependency] attribute from the event field to exported method for generated events. Fixes [#24262]. by @rolfbjarne in https://github.com/dotnet/macios/pull/24270
• [xcode26.2] Update AuthenticationServices to Xcode 26.2 Beta 1 by @dalexsoto in https://github.com/dotnet/macios/pull/24284
• [xcode26.2] Update to Xcode 26.2 Beta 2 by @dalexsoto in https://github.com/dotnet/macios/pull/24289
• [xcode26.2] Update AVFoundation bindings to Xcode 26.2 Beta 1 by @dalexsoto in https://github.com/dotnet/macios/pull/24285
• [Foundation] Fix nullability in NSUrlCredential. by @rolfbjarne in https://github.com/dotnet/macios/pull/24277
• [mlaunch] Update mlaunch to 1.1.93 by @mauroa in https://github.com/dotnet/macios/pull/24257
• [Foundation] Fix nullability in NSXpcConnection. by @rolfbjarne in https://github.com/dotnet/macios/pull/24268
• [Network] Fix NWBrowseResult.TxtRecord to not throw an exception if there's no TxtRecord. by @rolfbjarne in https://github.com/dotnet/macios/pull/24295
• [xcode26.2] Update GameKit bindings to Xcode 26.2 Beta 2 by @dalexsoto in https://github.com/dotnet/macios/pull/24302
• [Foundation] Fix nullability in NSUrlDownload. by @rolfbjarne in https://github.com/dotnet/macios/pull/24275
• [Foundation] Fix nullability in NSUrlProtectionSpace. by @rolfbjarne in https://github.com/dotnet/macios/pull/24271
• [xcode26.2] Update BrowserEngineKit bindings to Xcode 26.2 Beta 1 by @dalexsoto in https://github.com/dotnet/macios/pull/24287
• [Foundation] Fix nullability in NSTimeZone. by @rolfbjarne in https://github.com/dotnet/macios/pull/24304
• [xcode26.2] Update GameController bindings to Xcode 26.2 Beta 2 by @dalexsoto in https://github.com/dotnet/macios/pull/24297
• [xcode26.2] Update HealthKit bindings to Xcode 26.2 Beta 2 by @dalexsoto in https://github.com/dotnet/macios/pull/24307
• [Foundation] Fix nullability in NSUbiquitousKeyValueStore. by @rolfbjarne in https://github.com/dotnet/macios/pull/24278
• [Foundation] Document NSUrlSessionHandler.MaxInputInMemory. Fixes [#21537]. by @rolfbjarne in https://github.com/dotnet/macios/pull/24305
• [xcode26.2] Update PassKit bindings to Xcode 26.2 Beta 2 by @dalexsoto in https://github.com/dotnet/macios/pull/24310
• [Foundation] Fix nullability in NSUrlSession. by @rolfbjarne in https://github.com/dotnet/macios/pull/24269
• [xcode26.2] Merge main into xcode26.2 by @dalexsoto in https://github.com/dotnet/macios/pull/24318
• [xcode26.2] Update SafariServices bindings to Xcode 26.2 Beta 2 by @dalexsoto in https://github.com/dotnet/macios/pull/24320
• [xcode26.2] Update Security bindings to Xcode 26.2 Beta 2 by @dalexsoto in https://github.com/dotnet/macios/pull/24321
• [msbuild] Fix XcodeProject output path when using artifacts folder by @Copilot in https://github.com/dotnet/macios/pull/24224
• [tools] Mark the Invoke methods for the type to create block proxies when using the static registrar. by @rolfbjarne in https://github.com/dotnet/macios/pull/24344
• [Foundation] Fix nullability in NSStream. by @rolfbjarne in https://github.com/dotnet/macios/pull/24308
• [xcode26.2] Bump to Xcode 26.2 Release Candidate by @dalexsoto in https://github.com/dotnet/macios/pull/24359
• [xcode26.2] Merge main into xcode26.2 by @dalexsoto in https://github.com/dotnet/macios/pull/24357
• [Foundation] Improve documentation and remove redundant platform attributes in NSOrderedSet<TKey>. by @rolfbjarne in https://github.com/dotnet/macios/pull/24345
• [Foundation] Fix nullability in NSRange. by @rolfbjarne in https://github.com/dotnet/macios/pull/24356
• [CoreAnimation] Remove incorrect availability attributes from CASpringAnimation.SettlingDuration by @Copilot in https://github.com/dotnet/macios/pull/24341
• [Foundation] Fix nullability in NSScriptCommandDescription. by @rolfbjarne in https://github.com/dotnet/macios/pull/24351
• [Foundation] Fix nullability in NSSearchPath. by @rolfbjarne in https://github.com/dotnet/macios/pull/24350
• Look for runtime packs in Release instead of Debug for consistency with build-custom-runtime.sh by @rolfbjarne in https://github.com/dotnet/macios/pull/24342
• [Foundation] Fix nullability in NSSet<TKey>. by @rolfbjarne in https://github.com/dotnet/macios/pull/24349
• [Foundation] Fix NSObjectData leak. by @rolfbjarne in https://github.com/dotnet/macios/pull/24114
• [dotnet] Make sure the current MSI version is higher than the last inserted MSI version. by @rolfbjarne in https://github.com/dotnet/macios/pull/24374
• [Foundation] Ensure NSUrlSessionHandler's session is cleaned up on dispose. Fixes [#24376]. by @rolfbjarne in https://github.com/dotnet/macios/pull/24384
• [Foundation] Fix nullability in NSSet. by @rolfbjarne in https://github.com/dotnet/macios/pull/24309
• [dotnet] Fix computing the arguments to 'open'. by @rolfbjarne in https://github.com/dotnet/macios/pull/24330
• [Foundation] Fix nullability in NSScriptCommandArgumentDescription. by @rolfbjarne in https://github.com/dotnet/macios/pull/24355
• [src] Consume ADR from a NuGet instead of building it ourselves. by @rolfbjarne in https://github.com/dotnet/macios/pull/24381
• [Foundation] Fix nullability in NSOrderedSet. by @rolfbjarne in https://github.com/dotnet/macios/pull/24391
• [dotnet] Fix DOTNET_BCL_DIR when .NET's version hasn't caught up with DOTNET_TFM yet. by @rolfbjarne in https://github.com/dotnet/macios/pull/24394
• [dotnet-linker] Don't add the target framework to the output path. by @rolfbjarne in https://github.com/dotnet/macios/pull/24396
• [Foundation] Fix nullability in NSNull. by @rolfbjarne in https://github.com/dotnet/macios/pull/24406
• [Foundation] Fix nullability in NSNumber.mac.cs by @rolfbjarne in https://github.com/dotnet/macios/pull/24404
• [Foundation] Fix nullability in NSNumber2. by @rolfbjarne in https://github.com/dotnet/macios/pull/24405
• [runtime/msbuild] Clean up some unused code. by @rolfbjarne in https://github.com/dotnet/macios/pull/24409
• [Foundation] Fix nullability in NSMutableOrderedSet<TKey>. by @rolfbjarne in https://github.com/dotnet/macios/pull/24423
• [Foundation] Fix nullability in NSNotificationCenter. by @rolfbjarne in https://github.com/dotnet/macios/pull/24407
• [xcode26.2] Merge main into xcode26.2 by @dalexsoto in https://github.com/dotnet/macios/pull/24424
• [Foundation] Fix nullability in NSNetService. by @rolfbjarne in https://github.com/dotnet/macios/pull/24415
• [xcode26.2] Update to stable version of Xcode 26.2 by @dalexsoto in https://github.com/dotnet/macios/pull/24441
• [xcode26.2] Merge xcode26.2 into main by @dalexsoto in https://github.com/dotnet/macios/pull/24445
• [release/10.0.1xx] Merge main into release/10.0.1xx. by @rolfbjarne in https://github.com/dotnet/macios/pull/24448

New Contributors

• @mmitche made their first contribution in https://github.com/dotnet/macios/pull/24255

Full Changelog: https://github.com/dotnet/macios/compare/dotnet-10.0.1xx-xcode26.1-10502...dotnet-10.0.1xx-xcode26.2-10191