從 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 應用程式：

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 應用程式。