Skip to content

Releases: dotnet/macios

.NET 10.0.1xx Preview 1 (10322)

25 Feb 20:23
@rolfbjarne rolfbjarne
dotnet-10.0.1xx-preview1-10322
e32808d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
.NET 10.0.1xx Preview 1 (10322) Pre-release
Pre-release

We're excited to announce our first 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.1.25124.2 in order to install these versions of the SDKs, please make sure to be using the first 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.1.25124.2

Available workload ids

Example command installing all listed workloads.

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

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

What's Changed

Trimmer warnings enabled by default

In the past we've suppressed trimmer warnings, because the base class library produced trimmer warnings, which meant that it wouldn't be possible for developers to fix all the trimmer warnings.

However, in .NET 9 we believe we fixed all the trimmer warnings from our own code, so now we're ready to for developers to do the same, and thus we're enabling trimmer warnings by default.

This can be disabled, by adding this to the project file:

<PropertyGroup>
    <SuppressTrimAnalysisWarnings>true</SuppressTrimAnalysisWarnings>
</PropertyGroup>

Ref: #21293

Bundling original resources in libraries

Library projects can have various types of bundle resources (storyboards, xibs, property lists, png images, CoreML models, texture atlases, etc.), and they're bundled into the compiled library as embedded resources.

If any processing can be done (such as compiling storyboards or xibs, or optimizing property lists/png images, etc), this has historically been done before embedding, but this complicates library builds a lot, because this processing:

  • Needs to run on a Mac, because compiling xibs/storyboards can only be done on a Mac.
  • Needs Apple's toolchain around.
  • Makes it impossible to do any decision-making based on the original resources when building the app.

So we've added opt-in support for embedding the original resource in libraries in .NET 9, and making it opt-out in .NET 10.

The default behavior can be changed in the project file like this:

<PropertyGroup>
    <BundleOriginalResources>false</BundleOriginalResources>
</PropertyGroup>

Ref: #19028

API improvements / fixes / additions

Full Changelog: dotnet-9.0.1xx-xcode16.2-9173...dotnet-10.0.1xx-preview1-10320

Contributors

rolfbjarne
Loading

.NET 9 - Xcode 16.2 support (9180)

20 Feb 11:26
@rolfbjarne rolfbjarne
dotnet-9.0.1xx-xcode16.2-9180
63d5ccc
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
.NET 9 - Xcode 16.2 support (9180) Latest
Latest

🚨 Xcode 16.2 is required with this release. Xcode 16.2 requires macOS 14.5+ or 15.0+.

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] Update HotRestart.Client to 17.14.51-gd03e25086a by @rolfbjarne in #21994
  • [release/9.0.1xx] Update Hot Restart Client to 17.14.83-g77e8f56103 by @mauroa in #22034
  • [release/9.0.1xx] [CI] Use macOS Sequoia for building and testing by @dalexsoto in #22072
  • [release/9.0.1xx] Update Hot Restart Client to 17.14.133-g001ce2ac7a by @mauroa in #22129

Full Changelog: dotnet-9.0.1xx-xcode16.2-9173...dotnet-9.0.1xx-xcode16.2-9180

Contributors

dalexsoto, rolfbjarne, and mauroa
Assets 2
Loading

.NET 9 - Xcode 16.2 support (9173)

27 Jan 19:44
@dalexsoto dalexsoto
dotnet-9.0.1xx-xcode16.2-9173
b3ee0f2
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
.NET 9 - Xcode 16.2 support (9173)

🚨 Xcode 16.2 is required with this release. Xcode 16.2 requires macOS 14.5+ or 15.0+.

This is a servicing release to the previous .NET 9 release, with support for Xcode 16.2.

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.102.1 in order to install these versions of the SDKs, please make sure to be using the latest .NET SDK 9.0.102 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.102 or greater before proceeding.

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

Available workload ids

Example command installing all listed workloads.

dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.102.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.2-9170...dotnet-9.0.1xx-xcode16.2-9173

Contributors

rolfbjarne and vs-mobiletools-engineering-service2
Loading

.NET 9 - Xcode 16.2 support (9170)

19 Dec 16:00
@rolfbjarne rolfbjarne
dotnet-9.0.1xx-xcode16.2-9170
4c5dd93
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
.NET 9 - Xcode 16.2 support (9170)

🚨 Xcode 16.2 is required with this release. Xcode 16.2 requires macOS 14.5+ or 15.0+.

This is a servicing release to the previous .NET 9 release, with support for Xcode 16.2.

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.101.2 in order to install these versions of the SDKs, please make sure to be using the latest .NET SDK 9.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 9.0.101 or greater before proceeding.

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

Available workload ids

Example command installing all listed workloads.

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

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

What's changed

Marshaled managed exceptions will be treated as unhandled exceptions by debuggers

Generally managed exceptions shouldn't "leak" into native code - they will be converted into Objective-C exceptions, but Objective-C exceptions have many issues and this can cause runtime problems.

Additionally, some native code will just swallow all Objective-C exceptions, essentially making any managed exceptions that triggered those Objective-C exceptions entirely silent (AppKit does this in its UI loop - see dotnet/maui#7176).

With this change, debuggers will be notified just before a managed exception is converted into an Objective-C exception, and will treat it as an unhandled managed exception, which will be a great improvement. One current downside is that the debugger isn't notified when the exception is thrown, but at a later point, which means the current frame when the debugger is stopped isn't entirely helpful. Work is in progress to improve this as well, and hopefully at some point we'll be able to stop the debugger when such managed exceptions are thrown.

References:

What's Changed

Read more

Contributors

rolfbjarne, mandel-macaque, and haritha-mohan
Loading

.NET 8.0.1xxx - Xcode 16.0 Support (8319)

19 Dec 16:00
@rolfbjarne rolfbjarne
dotnet-8.0.1xx-xcode16.0-8319
0ee2837
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
.NET 8.0.1xxx - Xcode 16.0 Support (8319)

🚨 Xcode 16.0 is required with this release. Xcode 16 requires macOS 14.5+ or 15.0+.

This is a servicing release to the previous .NET 8 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

Full Changelog: dotnet-8.0.1xx-xcode16.0-8316...dotnet-8.0.1xx-xcode16.0-8319

Loading

.NET 9 - Xcode 16.1 support (9163)

26 Nov 13:01
@rolfbjarne rolfbjarne
dotnet-9.0.1xx-xcode16.1-9163
b07bd9d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
.NET 9 - Xcode 16.1 support (9163)

🚨 Xcode 16.1 is required with this release. Xcode 16.1 requires macOS 14.5+ or 15.0+.

This is a servicing release to the previous .NET 9 release, with support for Xcode 16.1.

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.101.1 in order to install these versions of the SDKs, please make sure to be using the latest .NET SDK 9.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 9.0.101 or greater before proceeding.

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

Available workload ids

Example command installing all listed workloads.

dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.101.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.0-9617...dotnet-9.0.1xx-xcode16.1-9163

Contributors

dalexsoto, rolfbjarne, and vs-mobiletools-engineering-service2
Loading

.NET 8.0.1xxx - Xcode 16.0 Support (8316)

26 Nov 13:01
@rolfbjarne rolfbjarne
dotnet-8.0.1xx-xcode16.0-8316
16d8ceb
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
.NET 8.0.1xxx - Xcode 16.0 Support (8316)

🚨 Xcode 16.0 is required with this release. Xcode 16 requires macOS 14.5+ or 15.0+.

This is a servicing release to the previous .NET 8 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

Full Changelog: dotnet-8.0.1xx-xcode16.0-8314...dotnet-8.0.1xx-xcode16.0-8316

Loading

.NET 9

13 Nov 21:46
@rolfbjarne rolfbjarne
dotnet-9.0.1xx-xcode16.0-9617
797d307
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
.NET 9

We're excited to announce our .NET 9 SDK 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/.

This release consists of the following versions:

Installation

You can use workload set version 9.0.100 in order to install these versions of the SDKs, please make sure to be using the latest .NET SDK 9.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 9.0.100 before proceeding.

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

Available workload ids

Example command installing all listed workloads.

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

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

Full release notes: https://github.com/xamarin/xamarin-macios/wiki/.NET-9-release-notes

Loading

.NET 8.0.1xxx - Xcode 16.0 Support (8314)

13 Nov 21:46
@rolfbjarne rolfbjarne
dotnet-8.0.1xx-xcode16.0-8314
8354d6d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
.NET 8.0.1xxx - Xcode 16.0 Support (8314)

🚨 Xcode 16.0 is required with this release. Xcode 16 requires macOS 14.5+ or 15.0+.

This is a servicing release to the previous .NET 8 release, with support for Xcode 16 and macOS 15.0 (Sequoia).

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

Full Changelog: dotnet-8.0.1xx-xcode16.0-8303...dotnet-8.0.1xx-xcode16.0-8314

Contributors

vs-mobiletools-engineering-service2
Loading

.NET 9.0.1xx RC 2 (9600)

08 Oct 16:52
@rolfbjarne rolfbjarne
dotnet-9.0.1xx-rc2-9600
a6599c7
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
.NET 9.0.1xx RC 2 (9600) Pre-release
Pre-release

We're excited to announce our second (and last) release candidate for .NET 9!

This release includes support for Xcode 16 and macOS 15.0 (Sequoia).

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:

🚨 This release requires Xcode 16.0

Installation

You can use workload set version 9.0.100-rc.2.24503.1 in order to install the 18.0.9600-net9-rc2 version of the iOS SDK, please make sure to be using the latest .NET SDK 9.0.100-rc.2 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.100-rc.2 before proceeding.

dotnet workload install <workload id(s)> --version 9.0.100-rc.2.24503.1

Available workload ids

Example command installing all listed workloads.

dotnet workload install ios tvos macos maccatalyst maui android --version 9.0.100-rc.2.24503.1

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

Full release notes: .NET 9 release notes

Known issues

VSCode on macOS 15.0 (Sequoia)

VSCode currently has some incompatibilities on macOS 15.0 (Sequoia). Full details (with workarounds) can be found here: microsoft/vscode-dotnettools#1449

The native strip tool might crash (and exit with exit code 139)

This is a bug in the native strip tool (shipped by Apple with Xcode).

The simplest workaround is to disable stripping by adding the following to your csproj (the downside is that the app size will increase somewhat):

<PropertyGroup>
    <NoSymbolStrip Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'ios'">True</NoSymbolStrip>
</PropertyGroup>

For more information: #19157

App submission denied because app references the BrowserEngineKit framework

The workaround is to add the following to the project file:

<Target Name="DoNotLinkWithBrowserEngineKit" AfterTargets="_ComputeLinkNativeExecutableInputs">
	<ItemGroup>
		<_NativeExecutableFrameworks Remove="BrowserEngineKit" />
	</ItemGroup>
</Target>

For more information: #21324

Binding projects don't build

Binding projects will fail to build with an error like this:

/usr/local/share/dotnet/packs/Microsoft.iOS.Sdk.net9.0_18.0/18.0.9600-net9-rc2/tools/msbuild/iOS/Xamarin.Shared.targets(1776,3): error MSB6006: "dotnet" exited with code 150.

It might be possible to work around this by installing a daily .NET 9 RTM build from here: https://github.com/dotnet/sdk/blob/main/documentation/package-table.md

For more information: #21407

Known issues in .NET 9: Known issues in .NET 9

What's Changed

  • [Accessibility] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #21070
  • [AccessorySetupKit] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #20857
  • [AppKit/UIKit] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #21130
  • [AudioToolbox] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #20856
  • [AuthenticationServices] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #21143
  • [AutomaticAssessmentConfiguration] Implement Xcode 16.0 beta 1, beta 2 and beta 3 changes. by @rolfbjarne in #20847
  • [AutomaticAssessmentConfiguration] Implement Xcode beta 5 changes. by @rolfbjarne in #21028
  • [AVFoundation] Add AVCaptureDeviceTypeExternal. by @rolfbjarne in #21190
  • [AVFoundation] Implement Xcode 16.0 beta 1, beta 2 and beta 3 changes (from AVFAudio only). by @rolfbjarne in #20851
  • [AVKit] Implement Xcode 15 + Xcode 16.0 beta 1, beta 2 and beta 3 changes. by @rolfbjarne in #20849
  • [bgen] Add methods to convert between arrays of strong enum values and their underlying native enum type. by @rolfbjarne in #21089
  • [bgen] Add support for delegates with pointer types. by @rolfbjarne in #21159
  • [bgen] Add support for more backing field types. by @rolfbjarne in #21172
  • [bgen] Add support for specifying the backing field for strong enums using a new BackingFieldType attribute. by @rolfbjarne in #21016
  • [bgen] Add warning to the list of exceptions instead of showing it right away. by @rolfbjarne in #21027
  • [bgen] Fix compiler warnings. by @rolfbjarne in #21184
  • [bgen] Fix detecting NSObject types and generating block code with types that aren't NSObjects. by @rolfbjarne in #21181
  • [bgen] Fix generating delegates with nullable return types. #17109. by @rolfbjarne in #21094
  • [bgen] Fix using arrays of INativeObjects in delegate signatures. by @rolfbjarne in #21183
  • [bgen] Fix using types that are in multiple namespaces. by @rolfbjarne in #21182
  • [bgen] Fully qualify the RequiredMember and OptionalMember attributes. Fixes #21073. by @rolfbjarne in #21076
  • [bgen] Generate Obsolete + EditorBrowsable attributes in a few more cases. by @rolfbjarne in #21135
  • [bgen] Improve nullability detection to detect the nullability attributes the C# compiler generates. Fixes #17130. by @rolfbjarne in #21099
  • [BrowserEngineKit] Implement this new framework. by @rolfbjarne in #21168
  • [BrowserEngineKit] Improve API a bit by making a few methods async. by @rolfbjarne in #21236
  • [CallKit] Implement Xcode 16.0 beta 1, beta 2 and beta 3 changes. by @rolfbjarne in #20858
  • [CarPlay] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #21039
  • [CloudKit] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #20861
  • [ContactProvider] Don't bind this framework. by @rolfbjarne in #21160
  • [Contacts] Implement Xcode 16.0 beta 1, beta 2 and beta 3 changes. by @rolfbjarne in #20860
  • [CoreAnimation] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #21050
  • [CoreAudioTypes] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #21019
  • [CoreBluetooth] Implement Xcode 16.0 beta 1, beta 2 and beta 3 changes. by @rolfbjarne in #20859
  • [CoreData] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #21113
  • [CoreFoundation] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #21116
  • [CoreGraphics] Bind the CGSession API. by @rolfbjarne in #21024
  • [CoreGraphics] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #21033
  • [CoreImage] Implement Xcode 16 beta 6 changes. by @rolfbjarne in #21117
  • [CoreLocation] Implement Xcode 16.0 beta 1, beta 2 and beta 3 changes. by @rolfbjarne in #20864
  • [CoreMedia] Implement Xcode 16 beta 3-6 changes. by @rolfbjarne in #21118
  • [CoreMedia] Implement Xcode 16 RC changes. by @rolfbjarne in #21226
  • [CoreMidi] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #20882
  • [CoreMidi] Move fields to the api definition. by @rolfbjarne in #21043
  • [CoreML] Implement Xcode 16.0 beta 1-6 changes. by @rolfbjarne in #21145
  • [CoreMotion] Implement Xcode 16.0 beta 1, beta 2 and b...
Read more

Contributors

rolfbjarne, pjcollins, and 3 other contributors
Loading