Xamarin.iOS & Xamarin.Mac Files

[!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, with support for Xcode 16.4.

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:

• iOS: 18.5.9199
• tvOS: 18.5.9199
• macOS: 15.5.9199
• Mac Catalyst: 18.5.9199

Installation

You can use workload set version 9.0.301.1 in order to install these versions of the SDKs, please make sure to be using the latest 9.0.301 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.301 or greater before proceeding.

:::sh
dotnet workload install <workload id(s)> --version 9.0.301.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 9.0.301.1

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

What's changed

Building binding projects on Windows without a Mac

Binding projects are now built entirely on Windows, there's no need for a remote Mac anymore.

This makes building binding projects on Windows significantly faster.

What's Changed

• [Accelerate] Fix all xtro todos for this framework by ignoring them all. by @rolfbjarne in https://github.com/dotnet/macios/pull/22574
• [AppKit] Improve and simplify the manually bound constructors for NSBitmapImageRep slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22676
• [AppKit] Improve and simplify the manually bound constructors for NSGradient slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22647
• [AppKit] Improve and simplify the manually bound constructors for NSImage slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22533
• [AppKit] Improve and simplify the manually bound constructors for NSOpenGLPixelFormat slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22716
• [AppKit] Improve and simplify the manually bound constructors for NSTextContainer slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22655
• [AppKit] Remove all !NET code. by @rolfbjarne in https://github.com/dotnet/macios/pull/22739
• [AVFoundation] Add a default ctor for AVRouteDetector. Fixes [#10139]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22534
• [AVFoundation] Implement up to Xcode 16.4 beta 1. by @rolfbjarne in https://github.com/dotnet/macios/pull/22753
• [AVFoundation] Improve and simplify the manually bound constructors for AVAudioRecorder slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22529
• [bgen] Add default xml docs for properties that represents fields. by @rolfbjarne in https://github.com/dotnet/macios/pull/22651
• [bgen] Add more xml docs for async operations. by @rolfbjarne in https://github.com/dotnet/macios/pull/22642
• [bgen] Add more xml docs for filters. by @rolfbjarne in https://github.com/dotnet/macios/pull/22641
• [bgen] Add support for writing xml docs for async methods. by @rolfbjarne in https://github.com/dotnet/macios/pull/22639
• [bgen] Add support for writing xml docs for events. by @rolfbjarne in https://github.com/dotnet/macios/pull/22640
• [bgen] Add xml docs for event args subclasses based on NSNotifications. by @rolfbjarne in https://github.com/dotnet/macios/pull/22570
• [bgen] Add xml docs for generated strong dictionary classes. by @rolfbjarne in https://github.com/dotnet/macios/pull/22569
• [bgen] Add xml docs to CIFilter constructors. by @rolfbjarne in https://github.com/dotnet/macios/pull/22545
• [bgen] Fix docid generation for nested types by @rolfbjarne in https://github.com/dotnet/macios/pull/22646
• [BGen] Fix the GC.KeepAlive issues with the BindAs attr. by @mandel-macaque in https://github.com/dotnet/macios/pull/22554
• [bgen] Fix xml docs for properties with backing fields. by @rolfbjarne in https://github.com/dotnet/macios/pull/22643
• [bgen] Inject documentation for the 'This' parameter we add to category methods. by @rolfbjarne in https://github.com/dotnet/macios/pull/22553
• [bgen] More xml docs for event args. by @rolfbjarne in https://github.com/dotnet/macios/pull/22588
• [CFNetwork] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22698
• [CloudKit] Improve and simplify a few manually bound constructors. by @rolfbjarne in https://github.com/dotnet/macios/pull/22657
• [CoreBluetooth] Fix nullability in a few CBCentralManager.ScanForPeripherals overloads. Fixes [#22610]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22630
• [CoreImage] Simplify CIFilter.OutputImage. by @rolfbjarne in https://github.com/dotnet/macios/pull/22711
• [CoreLocation] Improve and simplify the manually bound constructors for CLBeaconRegion slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22644
• [CoreTransferable] This is a Swift framework, so don't bind it. by @rolfbjarne in https://github.com/dotnet/macios/pull/22573
• [docs] Add docs on the branching codeflow. by @rolfbjarne in https://github.com/dotnet/macios/pull/22900
• [docs] Document NoSymbolStrip. by @rolfbjarne in https://github.com/dotnet/macios/pull/22880
• [docs] Update urls to document about exception marshaling. by @rolfbjarne in https://github.com/dotnet/macios/pull/22572
• [dotnet] Add a 'EnableProfiler' property to enable the 'diagnostics_tracing' component. Fixes [#19370]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22685
• [dotnet] Build all scripts before doing surgery on the local .NET installation. by @rolfbjarne in https://github.com/dotnet/macios/pull/22654
• [dotnet] Fix dependency tracking for aot compilation. Fixes [#21061]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22906
• [dotnet] Fix dependency tracking for trimming and native linking. Fixes [#21223]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22911
• [dotnet] Fix selecting NSUrlSessionHandler when not choosing a specific handler. by @rolfbjarne in https://github.com/dotnet/macios/pull/22863
• [dotnet] Improve entitlements lookup for AdditionalAppExtensions. Fixes [#19242]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22882
• [dotnet] Tweak error message about wrong Xcode version a bit. by @rolfbjarne in https://github.com/dotnet/macios/pull/22910
• [Foundation] Add a few missing NSDictionary members. Fixes [#22817]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22820
• [Foundation] Don't use ServicePointManager to get minimum TLS protocol. by @rolfbjarne in https://github.com/dotnet/macios/pull/22517
• [Foundation] Fix a CA1416 warning in RuntimeOptions.cs due to recent changes. by @rolfbjarne in https://github.com/dotnet/macios/pull/22883
• [Foundation] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22903
• [Foundation] Fix removal of background check in NSUrlSessionHandler. by @rolfbjarne in https://github.com/dotnet/macios/pull/22518
• [Foundation] Improve and simplify the manually bound constructors for NSAttributedString slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22587
• [Foundation] Improve and simplify the manually bound constructors for NSHttpCookie slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22740
• [Foundation] Improve and simplify the manually bound constructors for NSString slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22659
• [Foundation] Improve and simplify the manually bound constructors for NSThread slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22662
• [Foundation] Improve and simplify the manually bound constructors for NSUrlProtectionSpace slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22599
• [Foundation] Improve and simplify the manually bound constructors for NSUserDefaults slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22637
• [Foundation] NSUrlSessionHandler.ClientCertificateOptions is supported. by @rolfbjarne in https://github.com/dotnet/macios/pull/22884
• [FSKit] Re-introduce, it was finally released as stable in Xcode 16.3 / macOS 15.4. by @rolfbjarne in https://github.com/dotnet/macios/pull/22765
• [GameController] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22726
• [GameController] Implement up to Xcode 16.3. by @rolfbjarne in https://github.com/dotnet/macios/pull/22699
• [GameKit] Fix accidental breaking change in parameter name. by @rolfbjarne in https://github.com/dotnet/macios/pull/22586
• [GameKit] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22532
• [GameplayKit] Improve and simplify the manually bound constructors for GKPath slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22847
• [Intents] Improve and simplify the manually bound constructors for INPerson slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22544
• [MapKit] Improve and simplify the manually bound constructors for MKMapCameraZoomRange slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22542
• [MapKit] Improve and simplify the manually bound constructors for MKPointOfInterestFilter slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22595
• [MediaPlayer] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22552
• [Metal] Fix a few issues in MTLRasterizationRateLayerDescriptor. by @rolfbjarne in https://github.com/dotnet/macios/pull/22804
• [Metal] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22562
• [MetalPerformanceShaders] Improve the manually bound constructors for MPSCnnBinaryConvolutionNode and MPSCnnBinaryFullyConnectedNode slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22592
• [MetalPerformanceShaders] Remove all !NET code. by @rolfbjarne in https://github.com/dotnet/macios/pull/22563
• [MetalPerformanceShadersGraph] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22571
• [MetricKit] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22576
• [MetricKit] Fix an issue with availability attributes. by @rolfbjarne in https://github.com/dotnet/macios/pull/22810
• [ModelIO] Improve and simplify the manually bound constructors for MDLNoiseTexture slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22844
• [monotouch-test] Skip NWBrowserTest.TestStateChangesHandler in CI. by @rolfbjarne in https://github.com/dotnet/macios/pull/22888
• [msbuild/dotnet] Build binding projects on Windows instead of remotely. Fixes [#16244]. by @rolfbjarne in https://github.com/dotnet/macios/pull/21873
• [msbuild] A few project file improvements to make the msbuild projects work well in VSCode. by @rolfbjarne in https://github.com/dotnet/macios/pull/22811
• [msbuild] Don't execute the ParseDeviceSpecificBuildInformation task on Mac Catalyst. by @rolfbjarne in https://github.com/dotnet/macios/pull/22887
• [msbuild] Don't try to log a null exception. by @rolfbjarne in https://github.com/dotnet/macios/pull/22799
• [msbuild] Enable nullability in most files and fix any issues. by @rolfbjarne in https://github.com/dotnet/macios/pull/22857
• [msbuild] Enable nullability in the ParseDeviceSpecificBuildInformation task. Fixes [#22550]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22551
• [msbuild] Fix mistake: it's 'EnableProfiler', not 'EnableProfiling'. by @rolfbjarne in https://github.com/dotnet/macios/pull/22905
• [msbuild] Fix placing app extensions for Mac Catalyst. by @rolfbjarne in https://github.com/dotnet/macios/pull/22795
• [msbuild] Improve ComputeCodesignItems to take symlinked directories into account. Fixes [#20193]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22907
• [msbuild] Improve logging in XamarinTask.ExecuteAsync to show duration of external command. by @rolfbjarne in https://github.com/dotnet/macios/pull/22779
• [msbuild] Sort inputs when doing aot compilation and native compilation. by @rolfbjarne in https://github.com/dotnet/macios/pull/22755
• [msbuild] Validate a few macOS-only entitlements. Fixes [#22729]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22743
• [msbuild] Validate the required Xcode version. by @rolfbjarne in https://github.com/dotnet/macios/pull/22800
• [MultipeerConnectivity] Improve and simplify the manually bound constructors for MCSession slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22526
• [NaturalLanguage] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22589
• [NearbyInteraction] Fix all the xtro issues in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22581
• [Network] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22593
• [NetworkExtension] Improve and simplify the manually bound constructors for NEHotspotConfiguration slightly. by @rolfbjarne in https://github.com/dotnet/macios/pull/22665
• [ObjCRuntime] Fix all availability attributes. by @rolfbjarne in https://github.com/dotnet/macios/pull/22636
• [release/9.0.1xx] Use 'EnableDiagnostics' instead of 'EnableProfiler'. by @rolfbjarne in https://github.com/dotnet/macios/pull/22983
• [release/9.0.1xx][xma] Added targets and tasks to copy modified dll and pdb files back to Windows by @mauroa in https://github.com/dotnet/macios/pull/22680
• [runtime] Add ability to report how long app launch takes. Fixes [#22510]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22631
• [runtime] Fix skipping nested struct types when processing method type encodings. Fixes [#22837]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22859
• [runtime] Implement workaround for an interpreter bug where it returns incorrect small integer values to reverse P/Invokes. by @rolfbjarne in https://github.com/dotnet/macios/pull/22727
• [SceneKit] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22645
• [Security] Add SecKeyChain.QueryAsConcreteType to macOS. by @rolfbjarne in https://github.com/dotnet/macios/pull/22710
• [Security] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22664
• [Security] Implement up to Xcode 16.4 beta 1. by @rolfbjarne in https://github.com/dotnet/macios/pull/22754
• [SpriteKit] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22674
• [SpriteKit] Simplify SKVideoNode creation code. by @rolfbjarne in https://github.com/dotnet/macios/pull/22719
• [src] Document NSCoder.EncodeTo. by @rolfbjarne in https://github.com/dotnet/macios/pull/22543
• [src] Fix invalid xml comment by @rolfbjarne in https://github.com/dotnet/macios/pull/22638
• [src] Import xml docs for members, part 13. by @rolfbjarne in https://github.com/dotnet/macios/pull/22512
• [src] Import xml docs for members, part 14. by @rolfbjarne in https://github.com/dotnet/macios/pull/22531
• [src] Import xml docs for members, part 15. by @rolfbjarne in https://github.com/dotnet/macios/pull/22539
• [src] Import xml docs for members, part 16. by @rolfbjarne in https://github.com/dotnet/macios/pull/22594
• [src] Import xml docs for members, part 17. by @rolfbjarne in https://github.com/dotnet/macios/pull/22648
• [src] Import xml docs for members, part 18. by @rolfbjarne in https://github.com/dotnet/macios/pull/22652
• [src] Import xml docs for members, part 19. by @rolfbjarne in https://github.com/dotnet/macios/pull/22656
• [src] Import xml docs for members, part 20. by @rolfbjarne in https://github.com/dotnet/macios/pull/22658
• [src] Import xml docs for members, part 21. by @rolfbjarne in https://github.com/dotnet/macios/pull/22669
• [src] Import xml docs for members, part 22/22. by @rolfbjarne in https://github.com/dotnet/macios/pull/22678
• [src] Improve generics support. by @rolfbjarne in https://github.com/dotnet/macios/pull/22527
• [src] Numerous fixes in the xml docs. Fixes [#17399]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22715
• [src] Remove pointer-size checks and code. by @rolfbjarne in https://github.com/dotnet/macios/pull/22666
• [src] Simplify a few constants, and document them. by @rolfbjarne in https://github.com/dotnet/macios/pull/22577
• [src] Use InitializeHandle instead of calling the Handle setter in several types. by @rolfbjarne in https://github.com/dotnet/macios/pull/22879
• [StoreKit] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22690
• [SystemConfiguration] Fix accidental break in NetworkReachability.Schedule|Unschedule. by @rolfbjarne in https://github.com/dotnet/macios/pull/22912
• [SystemConfiguration] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22709
• [tools] Fix class_ptr rewriter to patch exception handlers too when instructions change. by @rolfbjarne in https://github.com/dotnet/macios/pull/22565
• [tools] Simplify class_ptr rewriter to not create new instructions when not needed. by @rolfbjarne in https://github.com/dotnet/macios/pull/22564
• [UIKit] Adjust nullability for UITableViewDelegate.WillDisplay[Header|Footer]View. Fixes [#9814]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22530
• [UIKit] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22720
• [UIKit] Fix UIBarButtonItem's callback logic. by @rolfbjarne in https://github.com/dotnet/macios/pull/22547
• [UIKit] Mark UIGraphicsRenderer and derived classes as thread-safe. Fixes [#22597]. by @rolfbjarne in https://github.com/dotnet/macios/pull/22600
• [UserNotifications] Fix nullability for UNUserNotificationCenter.GetPendingNotificationRequests's response. by @rolfbjarne in https://github.com/dotnet/macios/pull/22833
• [VideoToolbox] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22920
• [WebKit] Fix all availability attributes in this framework. by @rolfbjarne in https://github.com/dotnet/macios/pull/22848
• [xcode16.4] Bump to RC. by @rolfbjarne in https://github.com/dotnet/macios/pull/22824
• [xcode16.4] Bump to Xcode 16.4 stable by @dalexsoto in https://github.com/dotnet/macios/pull/22932
• [xharness] Remove some dead code. by @rolfbjarne in https://github.com/dotnet/macios/pull/22714
• [xma] Added targets and tasks to copy modified dll and pdb files back to Windows by @mauroa in https://github.com/dotnet/macios/pull/22677
• Bump to Xcode 16.4 beta 1. by @rolfbjarne in https://github.com/dotnet/macios/pull/22693
• Bump Xamarin.MacDev to get fix for finding Settings.plist from load Xamarin-based location. by @rolfbjarne in https://github.com/dotnet/macios/pull/22937
• Merge xcode16.4 into main. by @rolfbjarne in https://github.com/dotnet/macios/pull/22939
• Use feature flags for CFNetworkHandler and NSUrlSessionHandler by @mcumming in https://github.com/dotnet/macios/pull/22703

Full Changelog: https://github.com/dotnet/macios/compare/dotnet-9.0.1xx-xcode16.3-9288...dotnet-9.0.1xx-xcode16.4-9199