Udostępnij za pośrednictwem

Uaktualnianie Xamarin.Forms aplikacji do aplikacji MAUI platformy .NET przy użyciu asystenta uaktualniania platformy .NET

  • Artykuł

Asystent uaktualniania platformy .NET ułatwia uaktualnianie Xamarin.Forms projektów do interfejsu użytkownika aplikacji wieloplatformowej platformy .NET (.NET MAUI), konwertując plik projektu rozwiązania i wykonując typowe aktualizacje kodu. W szczególności narzędzie będzie:

  • Przekonwertuj Xamarin.Forms projekt biblioteki klas, projekt Xamarin.iOS i projekt platformy Xamarin.Android na projekty w stylu zestawu SDK.
  • Zaktualizuj platformę docelową w plikach projektu do net8.0-android i net8.0-ios, zgodnie z potrzebami.
  • Ustaw <UseMaui>true</UseMaui> w plikach projektu.
  • Dodaj dodatkowe właściwości projektu i usuń właściwości projektu, które nie są wymagane.
  • Dodawanie i usuwanie określonych pakietów NuGet:
    • Xamarin.Forms Usuń pakiety i Xamarin.Essentials NuGet.
    • Zastąp Xamarin.CommunityToolkit pakiet NuGet pakietem .NET MAUI Community Toolkit NuGet.
    • Zastąp Xamarin.Forms zgodne wersje SkiaSharp pakietów NuGet wersjami zgodnymi z programem .NET MAUI, jeśli są używane.
  • Usuń odwołania do Xamarin.Essentials przestrzeni nazw i zastąp Xamarin.Forms przestrzeń nazw przestrzeniami Microsoft.Maui nazw i Microsoft.Maui.Controls .

Po uruchomieniu narzędzia wymagane będzie dodatkowe nakłady pracy w celu ukończenia migracji.

Uwaga

Asystent uaktualniania platformy .NET dla platformy .NET MAUI nie obsługuje uaktualniania projektów platformy UWP, projektów rozszerzeń systemu iOS ani projektów powiązań.

Aby uzyskać więcej informacji na temat asystenta uaktualniania platformy .NET, w tym innych typów aplikacji, które można przekonwertować, zobacz Omówienie Asystenta uaktualniania platformy .NET.

Rozpocznij

Asystent uaktualniania platformy .NET jest dostępny jako rozszerzenie programu Visual Studio w systemie Windows oraz jako narzędzie interfejsu wiersza polecenia dla systemów Windows i Mac. Aby go używać, Xamarin.Forms projekt musi używać Xamarin.Forms wersji 4.8 lub nowszej. Jednak w celu uzyskania najlepszego sukcesu zalecamy, aby Xamarin.Forms projekt używał wersji Xamarin.Forms 5.0 i .NET Standard 2.0 lub nowszej.

Ważne

Asystent uaktualniania platformy .NET dla programu .NET MAUI jest nadal opracowywany. Prześlij opinię z etykietą "area:Maui", abyśmy mogli kontynuować ulepszanie tego narzędzia.

Asystent uaktualnienia platformy .NET wyświetli monit o typ uaktualnienia do wykonania:

  • W miejscu: ta opcja uaktualnia projekt bez tworzenia kopii.
  • Obok siebie: ta opcja kopiuje projekt i uaktualnia kopię, pozostawiając oryginalny projekt sam. Obecnie uaktualnienie równoległe programu MAUI platformy .NET wymaga utworzenia nowych projektów w celu uaktualnienia poszczególnych głównych projektów. Próba uaktualnienia nagłówka projektu do istniejącego projektu prawdopodobnie spowoduje błędy i nie jest obecnie obsługiwanym środowiskiem.

Przed uaktualnieniem Xamarin.Forms aplikacji do programu .NET MAUI należy najpierw zaktualizować Xamarin.Forms aplikację do użycia Xamarin.Forms 5 i upewnić się, że nadal działa prawidłowo. Ponadto należy zaktualizować zależności używane przez aplikację do najnowszych wersji.

Pomoże to uprościć resztę procesu migracji, ponieważ zminimalizuje różnice między interfejsem Xamarin.Forms API a programem .NET MAUI i zapewni, że używasz zgodnych wersji zależności platformy .NET, jeśli istnieją.

Szybkie akcje w programie Visual Studio

Asystent uaktualniania platformy .NET ma szybką akcję konwertowania Xamarin.Forms przestrzeni nazw na odpowiednie przestrzenie nazw .NET MAUI, które są wyświetlane jako żarówka:

Screenshot of previewing the application of a light bulb suggestion.

Szybka akcja spowoduje zastąpienie niezbędnego pliku.

Uwaga

Żarówki szybkiej akcji będą wyświetlane podczas migrowania plików z Xamarin.Forms projektu do projektu .NET MAUI.

Instalacja

Program Visual Studio 2022 w wersji 17.6.0 lub nowszej zdecydowanie zaleca się uruchomienie asystenta uaktualniania. Aby zainstalować rozszerzenie asystenta uaktualniania:

  1. Otwórz program Visual Studio i wybierz element menu Rozszerzenia > Zarządzaj rozszerzeniami .
  2. W oknie dialogowym Zarządzanie rozszerzeniami wyszukaj i pobierz Asystenta uaktualniania platformy .NET.
  3. Po pobraniu rozszerzenia zamknij program Visual Studio. Rozszerzenie zostanie następnie zainstalowane.

Rozszerzenia są aktualizowane automatycznie, gdy nowa wersja jest dostępna w witrynie Visual Studio Marketplace. Aby uzyskać więcej informacji, zobacz Automatyczne aktualizacje rozszerzeń.

Uruchamianie asystenta uaktualniania

Kliknij prawym przyciskiem myszy projekt w Eksplorator rozwiązań i wybierz pozycję Uaktualnij.

Następne kroki

Migracja ręczna