重要
Microsoft对 Xamarin 的支持 将于 2024 年 5 月 1 日结束，包括 Xamarin.Forms 在内的所有 Xamarin SDK。 通过完成此 简短调查，帮助我们改进从 Xamarin 到 .NET MAUI 的升级体验。
完成升级过程后，Xamarin 项目可以在 .NET 上运行。 下表列出了可升级到 .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 原生项目 |
| 金属 | ✅ | 升级 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 应用：
- 将 Xamarin.Forms 解决方案中的 Xamarin 本机项目升级到 .NET。 有关详细信息，请参阅 将 Xamarin.Android、Xamarin.iOS 和 Xamarin.Mac 应用升级到 .NET。 此外，可以将 Xamarin.Forms UWP 项目升级到 .NET MAUI WinUI 3 项目。 有关详细信息，请参阅 Xamarin.Forms UWP 项目迁移。
- 将 Xamarin.Forms 库项目升级到 .NET 多平台应用 UI（.NET MAUI）。 有关详细信息，请参阅 手动将 Xamarin.Forms 应用升级到多项目 .NET MAUI 应用。
或者，可以手动将 Xamarin.Forms 应用升级到单项目 .NET MAUI 应用。 有关详细信息，请参阅 手动将 Xamarin.Forms 应用升级到单个项目 .NET MAUI 应用。
