.NET 6: documentation

[rolfbjarne]

This is a list of things we'll want to document about our .NET 6 support.

CFNetworkHandler

It won't be possible to select CFNetworkHandler as the default handler (it will still be possible to manually pass to to HttpClient).

Deprecated NuGet packages which won't work

• System.Data.SqlClient (replaced by Microsoft.Data.SqlClient)
• System.Json (use System.Text.Json instead)
• System.Xml.XPath.XmlDocument

Ref: #11710
Ref: dotnet/designs#222 (comment)

Exception marshaling is enabled by default

'dotnet pack' doesn't work for projects with multiple target frameworks

'dotnet pack' doesn't work for projects using TargetFrameworks (plural) instead of TargetFramework (singular).

Workaround: use TargetFramework in the csproj.

Ref: #14708

Ran out of trampolines of type 1 running on x64 simulator

Ref: #14887
Ref: dotnet/runtime#68808

Known issues

• Specifying both -f ... and -r ... to dotnet build fails to restore if multiple frameworks are present in the project file dotnet/sdk#21877

[rolfbjarne]

This has been moved to:

• https://github.com/xamarin/xamarin-macios/wiki/Known-issues-in-.NET
• https://github.com/xamarin/xamarin-macios/wiki/Breaking-changes-in-.NET