-
Notifications
You must be signed in to change notification settings - Fork 511
.NET 8 release notes
Warning This document is still work-in-progress/incomplete.
We're excited to announce our .NET 8 SDK release!
Note: these are the base SDKs that add support for the platforms in question, if you are looking for .NET MAUI (which is built on top of our SDKs), go here instead: https://docs.microsoft.com/en-us/dotnet/maui/.
Getting Started | What's New | Known Issues | Feedback | FAQ
This release consists of the following versions:
- iOS: ...
- tvOS: ...
- macOS: ...
- Mac Catalyst: ...
It's highly recommended to use Xcode 15.0+ (which requires macOS 13.? (Ventura)). Earlier versions of Xcode may work, but some features won't be available.
With the release the minimum supported OS versions can be targeted for apps:
- iOS: 11.0
- macOS: 10.15
- tvOS: 11.0
- Mac Catalyst: 13.1
Note: while we support macOS 10.15, we're only testing on OS versions that Apple supports. At the time of this writing this means we're only testing on macOS 12.0+.
In contrast to how Xamarin.iOS and Xamarin.Mac were shipped (as installable *.pkg
files), our .NET SDKs are shipped as workloads in the .NET world. This means that the first step is to getting started is to install .NET 8.0.100 (or later).
Then install the workload corresponding with the desired platform:
$ dotnet workload install ios # other workloads: macos, tvos, and maccatalyst
Create new app from a template with:
$ dotnet new ios # 'dotnet new --list --tag Mobile' will show all available templates
Finally build and run the new app in the simulator
$ dotnet run
This release contains SDKs for the following four platforms: iOS, tvOS, Mac Catalyst and macOS, and has support and bindings for the OS versions that were shipped with Xcode 15.0:
- iOS ?
- macOS ?
- tvOS ?
- Mac Catalyst ?
It's currently not possible to run a mobile app (iOS, tvOS) on Windows using the command line. Please use an IDE to launch apps from Windows.
Ref: https://github.com/xamarin/xamarin-macios/issues/16609
The general process is documented here:
https://docs.microsoft.com/en-us/dotnet/maui/ios/cli
but does not include running on an attached device.
To do that, include -p:RuntimeIdentifier=ios-arm64
, along with the other parameters.
dotnet build -t:Run -f:net7.0-ios -p:RuntimeIdentifier=ios-arm64 -p:_DeviceName=MY_SPECIFIC_UUID
with MY_SPECIFIC_UUID found as described here but for your device.
Note that this does not work from Windows, only from a Mac.
File issues here: https://github.com/xamarin/xamarin-macios/issues/new.
- README
- xcode13.0 Binding Status
- xcode13.1 Binding Status
- xcode13.2 Binding Status
- xcode13.3 Binding Status
- xcode13.4 Binding Status
- xcode14.0 Binding Status
- xcode14.1 Binding Status
- xcode14.2 Binding Status
- xcode14.3 Binding Status
- xcode15.0 Binding Status
- xcode15.1 Binding Status
- xcode15.3 Binding Status
- xcode15.4 Binding Status
- xcode16.0 Binding Status
- xcode16.1 Binding Status