從 Xamarin 升級至 .NET
重要
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 原生專案 |
| Metal | ✅ | 升級 Xamarin 原生專案 |
| Opengl | ❌ （iOS） | 已從 iOS 移除，因為 OpenTK 無法使用 |
| Xamarin.watchOS | ❌ | 建議：搭配適用於 iOS 應用程式的 .NET 搭配 Swift 擴充功能 |
重要
若要將應用程式從 Xamarin 升級至 .NET：
- 所有專案 都需要 成為 SDK 樣式。
- 專案 不需要 重寫。
- 多項目解決方案 不需要 成為多目標單一專案。
若要將 Xamarin 原生項目升級至 .NET，您必須先將專案更新為 SDK 樣式專案，然後將相依性更新為 .NET 8。 如需詳細資訊，請參閱 將 Xamarin.Android、Xamarin.iOS 和 Xamarin.Mac 項目升級至 .NET。
.NET 升級小幫手是命令行工具，可協助您將多專案 Xamarin.Forms 應用程式升級至多專案 .NET 多平台應用程式 UI （.NET MAUI） 應用程式。 執行此工具之後，在大部分情況下，應用程式將需要額外的工作才能完成升級。 如需詳細資訊，請參閱 使用 .NET Upgrade Assistant 將 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 應用程式。
