从 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 应用：
- 将 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 应用。
