从 Xamarin 升级为 .NET

重要

Microsoft 对 Xamarin 的支持将于 2024 年 5 月 1 日结束，包括 Xamarin.Forms 在内的所有 Xamarin SDK。 通过完成此 简短调查，帮助我们改进从 Xamarin 到 .NET MAUI 的升级体验。

进行升级后，在 .NET 上运行 Xamarin 项目。 下表列出了可升级到 .NET 的 Xamarin 项目类型：

项目类型	升级	指导
Xamarin.Android	✅	升级 Xamarin 本机项目
Xamarin.iOS	✅	升级 Xamarin 本机项目
Xamarin.Mac	✅	升级 Xamarin 本机项目
Xamarin.TVOS	✅	升级 Xamarin 本机项目
Xamarin.Forms	✅	将 Xamarin.Forms 应用升级到多项目 .NET MAUI 应用 将 Xamarin.Forms 应用升级到单个项目 .NET MAUI 应用
Xamarin.Forms UWP	✅	Xamarin.Forms UWP 项目迁移
iOS 应用扩展	✅	升级 Xamarin 本机项目
Android Wear	✅	升级 Xamarin 本机项目
Android 绑定库	✅	Xamarin.Android 绑定项目迁移
iOS 绑定库	✅	Xamarin.iOS 绑定项目迁移
SpriteKit	✅	升级 Xamarin 本机项目
SceneKit	✅	升级 Xamarin 本机项目
Metal	✅	升级 Xamarin 本机项目
OpenGL	❌ (iOS)	从 iOS 中删除，因为 OpenTK 不可用
Xamarin.watchOS	❌	建议：将 Swift 扩展与适用于 iOS 应用的 .NET 捆绑在一起

重要说明

将应用从 Xamarin 升级到 .NET：

• 所有项目 都需要 成为 SDK 样式。
• 无需重写项目。
• 多项目解决方案 不需要 成为多目标单一项目。

若要将 Xamarin 本机项目升级到 .NET，首先必须将项目更新为 SDK 样式的项目，然后将依赖项更新为 .NET 8。 有关详细信息，请参阅 将 Xamarin.Android、Xamarin.iOS 和 Xamarin.Mac 项目升级到 .NET。

.NET 升级助手是一种命令行工具，可帮助你将多项目 Xamarin.Forms 应用升级到多项目 .NET 多平台应用 UI （.NET MAUI） 应用。 在运行此工具后，大多数情况下，应用将需要其他操作才能完成迁移。 有关详细信息，请参阅使用 .NET 升级助手将 Xamarin.Forms 应用程序升级为 .NET MAUI 应用程序。

还可以使用两个步骤在 Xamarin.Forms 应用中手动升级到多项目 .NET MAUI 应用：

1. 将 Xamarin.Forms 解决方案中的 Xamarin 本机项目升级到 .NET。 有关详细信息，请参阅 将 Xamarin.Android、Xamarin.iOS 和 Xamarin.Mac 应用升级到 .NET。 此外，可以将 Xamarin.Forms UWP 项目升级到 .NET MAUI WinUI 3 项目。 有关详细信息，请参阅 Xamarin.Forms UWP 项目迁移。
2. 将 Xamarin.Forms 库项目升级到 .NET 多平台应用 UI（.NET MAUI）。 有关详细信息，请参阅 手动将 Xamarin.Forms 应用升级到多项目 .NET MAUI 应用。

或者，可以手动将 Xamarin.Forms 应用升级到单项目 .NET MAUI 应用。 有关详细信息，请参阅 手动将 Xamarin.Forms 应用升级到单个项目 .NET MAUI 应用。