Share via

Xamarin.Forms Upgrade aplikace na aplikaci .NET MAUI pomocí Pomocníka pro upgrade .NET

  • Článek

Pomocník pro upgrade na .NET pomáhá upgradovat Xamarin.Forms projekty na uživatelské rozhraní multiplatformních aplikací .NET MAUI (.NET MAUI) převodem souboru projektu řešení a prováděním běžných aktualizací kódu. Konkrétně nástroj:

  • Xamarin.Forms Převeďte projekt knihovny tříd, projekt Xamarin.iOS a projekt Xamarin.Android na projekty ve stylu sady SDK.
  • Podle potřeby aktualizujte cílovou architekturu v souborech projektu na net8.0-android a net8.0-iospodle potřeby.
  • Nastavte <UseMaui>true</UseMaui> v souborech projektu.
  • Přidejte další vlastnosti projektu a odeberte vlastnosti projektu, které nejsou povinné.
  • Přidejte a odeberte konkrétní balíčky NuGet:
    • Xamarin.Forms Odeberte balíčky NuGet a Xamarin.Essentials balíčky NuGet.
    • Xamarin.CommunityToolkit Nahraďte balíček NuGet balíčkem .NET MAUI Community Toolkit NuGet.
    • V případě použití nahraďte Xamarin.Forms kompatibilní verze SkiaSharp balíčků NuGet kompatibilními s rozhraním .NET MAUI.
  • Odeberte odkazy na Xamarin.Essentials obor názvů a nahraďte ho Xamarin.Forms oborem Microsoft.Maui názvů a Microsoft.Maui.Controls obory názvů.

Po spuštění nástroje se k dokončení migrace bude vyžadovat další úsilí.

Poznámka:

Pomocník pro upgrade .NET pro .NET MAUI nepodporuje upgrade projektů UPW, projektů rozšíření pro iOS ani vazeb projektů.

Další informace o pomocníkovi pro upgrade platformy .NET, včetně ostatních typů aplikací, které může převést, najdete v tématu Přehled pomocníka pro upgrade platformy .NET.

Začínáme

Pomocník pro upgrade platformy .NET je k dispozici jako rozšíření sady Visual Studio ve Windows a jako nástroj rozhraní příkazového řádku pro Windows a Mac. Abyste ho mohli použít, musí váš Xamarin.Forms projekt používat Xamarin.Forms verzi 4.8 nebo vyšší. Pro zajištění nejlepšího úspěchu však doporučujeme, aby váš Xamarin.Forms projekt používal Xamarin.Forms verzi 5.0 a .NET Standard 2.0 nebo vyšší.

Důležité

Pomocník pro upgrade .NET pro .NET MAUI je stále ve vývoji. Pošlete nám prosím zpětnou vazbu s popiskem area:Maui, abychom mohli tento nástroj dál vylepšovat.

Pomocník pro upgrade platformy .NET vás vyzve k zadání typu upgradu, který má provést:

  • Místní: Tato možnost upgraduje projekt bez vytvoření kopie.
  • Vedle sebe: Tato možnost zkopíruje projekt a upgraduje kopii a ponechá původní projekt sám. V současné době vyžaduje souběžný upgrade .NET MAUI vytvoření nových projektů pro upgrade jednotlivých hlavních projektů. Při pokusu o upgrade vedoucího projektu do existujícího projektu pravděpodobně dojde k chybám a v současné době se nejedná o podporované prostředí.

Před upgradem Xamarin.Forms aplikace na .NET MAUI byste nejprve měli aplikaci aktualizovat Xamarin.Forms tak, aby používala Xamarin.Forms 5, a ujistěte se, že stále běží správně. Kromě toho byste měli aktualizovat závislosti, které vaše aplikace používá, na nejnovější verze.

To pomůže zjednodušit zbytek procesu migrace, protože minimalizuje rozdíly Xamarin.Forms mezi rozhraním API a .NET MAUI a zajistí, že používáte kompatibilní verze .NET závislostí, pokud existují.

Rychlé akce v sadě Visual Studio

Pomocník pro upgrade platformy .NET má rychlou akci pro převod Xamarin.Forms oborů názvů na příslušné obory názvů .NET MAUI, které se zobrazí jako žárovka:

Screenshot of previewing the application of a light bulb suggestion.

Rychlá akce provede potřebné nahrazení souboru.

Poznámka:

Žárovky rychlé akce se zobrazí při migraci souborů z Xamarin.Forms projektu do projektu .NET MAUI.

Instalace

Visual Studio 2022 verze 17.6.0 nebo novější důrazně doporučujeme spustit pomocníka pro upgrade. Instalace rozšíření Pomocníka pro upgrade:

  1. Otevřete Visual Studio a vyberte položku nabídky Rozšíření > Spravovat rozšíření .
  2. V dialogovém okně Spravovat rozšíření vyhledejte a stáhněte Pomocníka pro upgrade .NET.
  3. Po stažení rozšíření zavřete Visual Studio. Rozšíření se pak nainstaluje.

Rozšíření se aktualizují automaticky, když je na Visual Studio Marketplace dostupná nová verze. Další informace naleznete v tématu Automatické aktualizace rozšíření.

Spuštění pomocníka pro upgrade

Klikněte pravým tlačítkem myši na projekt v Průzkumník řešení a vyberte Upgradovat.

Další kroky

Ruční migrace