Co to jest asystent uaktualnienia platformy .NET?

Asystent uaktualniania platformy .NET pomaga uaktualniać projekty do nowszych wersji platformy .NET i analizuje kod w celu wykrycia i naprawienia potencjalnych niezgodności. Jednym z głównych elementów narzędzia jest ułatwienie uaktualnienia projektu z programu .NET Framework, .NET Core lub .NET do najnowszej wersji platformy .NET. Asystent uaktualniania platformy .NET służy do uaktualniania całych projektów .NET lub niektórych aspektów projektu, takich jak uaktualnianie pliku konfiguracji ze starszego typu do nowszego typu.

Asystent aktualizacji .NET jest wbudowany w program Visual Studio i można go zainstalować jako narzędzie interfejsu wiersza polecenia .NET.

Ważne

Asystent uaktualnienia platformy .NET jest oficjalnie przestarzały. Zamiast tego użyj agenta czatu modernizacji narzędzia GitHub Copilot, który jest dołączony do Visual Studio 2026 oraz Visual Studio 2022 w wersji 17.14.16 lub nowszej. Ten agent analizuje projekty i zależności, tworzy plan migracji krok po kroku z ukierunkowanymi zaleceniami i automatycznymi poprawkami kodu oraz zatwierdza każdą zmianę, aby można było zweryfikować lub wycofać. Automatyzuje typowe zadania przenoszenia — aktualizowanie plików projektu, zastępowanie przestarzałych interfejsów API i rozwiązywanie problemów z kompilacją — dzięki czemu można szybciej zmodernizować przy mniejszym wysiłku ręcznym.

Analizowanie i uaktualnianie

Asystent uaktualniania platformy .NET zawiera aparat analizy, który skanuje projekty i ich zależności. Po zakończeniu skanowania raport jest generowany ze szczegółowymi informacjami na temat przeprowadzania uaktualnienia. Te informacje umożliwiają uaktualnienie całego projektu lub określonych części projektu.

Obsługiwane typy projektów

Asystent uaktualniania platformy .NET obsługuje uaktualnianie projektów zakodowanych w języku C# lub Visual Basic. Obsługiwane są następujące typy projektów:

  • ASP.NET
  • Azure Functions
  • Windows Presentation Foundation
  • Windows Forms
  • Biblioteki klas
  • Aplikacje konsolowe
  • Xamarin Forms
  • .NET MAUI
  • Natywna platforma .NET UWP

Niektóre produkty zawierają wskazówki dotyczące korzystania z asystenta uaktualniania platformy .NET.

Ścieżki uaktualniania

Obsługiwane są następujące ścieżki uaktualniania:

  • .NET Framework do .NET
  • .NET Core do .NET
  • Azure Functions v1-v3 na v4 w trybie izolowanym (celowanie w net6.0 lub nowszą wersję)
  • Od UWP do WinUI 3
  • Poprzednia wersja platformy .NET do najnowszej wersji platformy .NET
  • Przejście z Xamarin Forms na .NET MAUI
    • Przekształcenia plików XAML obsługują tylko uaktualnianie przestrzeni nazw. Aby uzyskać bardziej kompleksowe przekształcenia, użyj programu Visual Studio 2022 lub nowszego.

Szczegóły i opcje uaktualniania

Po rozpoczęciu uaktualniania kreator przeprowadzi Cię przez proces konfigurowania niektórych opcji przed zainicjowaniem uaktualnienia. Na podstawie typu projektu, który aktualizujesz, kreator przedstawia różne opcje. Aby zapoznać się z przykładem uaktualniania projektu, zobacz Uaktualnianie projektów przy użyciu asystenta uaktualniania platformy .NET.

Jak należy przeprowadzić uaktualnienie

Na podstawie typu projektu, który uaktualniasz, możesz zmienić sposób wykonywania uaktualnienia. Typ projektu ma wpływ na dostępne opcje i może brakować co najmniej jednego z następujących elementów:

  • Uaktualnienie projektu na miejscu

    Ta opcja uaktualnia projekt bez tworzenia kopii.

  • Uaktualnianie projektu równoległego

    Kopiuje projekt i uaktualnia kopię, nie zmieniając oryginalnego projektu.

  • Przyrostowe równoległe

    Jest to dobry wybór dla skomplikowanych aplikacji internetowych. Uaktualnienie z ASP.NET do ASP.NET Core wymaga sporo pracy i czasami ręcznej refaktoryzacji. Ten tryb umieszcza projekt .NET obok istniejącego projektu .NET Framework. Punkty końcowe są kierowane przez projekt .NET, podczas gdy wszystkie inne wywołania są wysyłane do aplikacji .NET Framework.

    Ten tryb umożliwia powolne uaktualnianie ASP.NET lub aplikacji biblioteki po kawałku.

Wyniki aktualizacji

Po zakończeniu uaktualniania zostanie wyświetlony ekran stanu przedstawiający wszystkie artefakty skojarzone z uaktualnieniem. Każdy artefakt uaktualnienia można rozwinąć, aby przeczytać więcej informacji o jego stanie. Na poniższej liście opisano ikony stanu:

  • Niezapełniony zielony znacznik wyboru: narzędzie nie znalazło żadnych informacji o artefaktie w celu uaktualnienia.
  • Wypełniony zielony znacznik: artefakt został pomyślnie uaktualniony i ukończony.
  • Żółty znak ostrzeżenia: artefakt został uaktualniony, ale należy wziąć pod uwagę ważne informacje.
  • Czerwony X: uaktualnienie artefaktu nie powiodło się.

Karta wyników uaktualniania Asystenta modernizacji platformy .NET w programie Visual Studio.

Ponadto akcje wykonywane podczas uaktualniania są rejestrowane w oknie Dane wyjściowe jako pochodzące ze źródła Asystent uaktualniania, jak pokazano na poniższej ilustracji:

Okno wyjściowe w programie Visual Studio z wynikami Asystenta Uaktualniania platformy .NET.

Po uaktualnieniu projektu przetestuj go dokładnie!

Powiązana zawartość

  • Last updated on