Instalowanie Asystenta uaktualniania platformy .NET

W tym artykule pokazano, jak zainstalować asystenta uaktualniania platformy .NET w programie Visual Studio lub za pomocą narzędzia interfejsu wiersza polecenia.

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.

Wymagania wstępne

• System operacyjny Windows
• Visual Studio 2026 (lub Visual Studio 2022 w wersji 17.14.17 lub nowszej).
• Zestaw .NET SDK 8 lub nowszy.

Metody

Asystent uaktualniania platformy .NET jest wbudowany w program Visual Studio lub można go zainstalować jako narzędzie globalne platformy .NET.

Asystent uaktualniania działa w programie Visual Studio w otwartym rozwiązaniu lub projekcie. Narzędzie globalne platformy .NET to interaktywna aplikacja konsolowa, która jest uruchamiana w pliku rozwiązania lub projektu w lub poniżej bieżącego katalogu.

Jeśli chcesz usprawnić środowisko otwierania projektu w programie Visual Studio i uaktualniania go, użyj Asystenta uaktualniania.

Visual Studio

Poniższe kroki umożliwiają włączenie starszego Asystenta uaktualniania w programie Visual Studio.

1. Otwórz program Visual Studio.

   Jeśli zostanie otwarte okno Otwórz ostatnie \ Wprowadzenie, wybierz link Kontynuuj bez kodu.

2. Wybierz menu Opcje narzędzi>, które otwiera okno Opcje.

3. Przejdź do Wszystkie ustawienia>Projekty i rozwiązania>Modernizacja.

4. Wybierz element Włącz starszego asystenta aktualizacji.

5. Uruchom ponownie program Visual Studio

   

Globalne narzędzie .NET

Poniższe kroki umożliwiają zainstalowanie asystenta uaktualniania platformy .NET jako narzędzia globalnego platformy .NET. .NET Upgrade Assistant jest dystrybuowany w pakiecie NuGet upgrade-assistant.

1. Otwórz wiersz polecenia, w którym polecenie dotnet jest dostępne w ścieżce systemowej.

2. Uruchom następujące polecenie, aby zainstalować narzędzie:

   dotnet tool install -g upgrade-assistant
   

   Ważne

   Zainstalowanie tego narzędzia może zakończyć się niepowodzeniem, jeśli skonfigurowano inne źródło źródła danych NuGet. Użyj parametru --ignore-failed-sources , aby traktować te błędy jako ostrzeżenia zamiast błędów, pomijając te inne źródła kanału informacyjnego NuGet:

   dotnet tool install -g --ignore-failed-sources upgrade-assistant
   

Walidacja

Poniższe informacje ułatwiają ustalenie, czy jest zainstalowany asystent uaktualniania platformy .NET.

• Visual Studio

  Aby określić, czy jest włączony asystent uaktualnienia platformy .NET, kliknij prawym przyciskiem myszy dowolny projekt .NET lub .NET Framework w oknie Eksplorator rozwiązań i sprawdź element menu Uaktualnianie .

• Narzędzie globalne platformy .NET

  Otwórz wiersz polecenia i uruchom upgrade-assistant polecenie . Jeśli odpowiedź polecenia wskazuje, że polecenie jest nieznane, narzędzie nie zainstalowało się poprawnie lub nie znajduje się w ścieżce PATH.

Rozwiązywanie problemów — narzędzie globalne platformy .NET

Jeśli skonfigurowano dodatkowe źródła kanałów informacyjnych NuGet, instalacja może zakończyć się niepowodzeniem z powodu błędu wskazującego, że pakiet NuGet nie jest dostępny w kanale informacyjnym. Użyj parametru --ignore-failed-sources , aby traktować te błędy jako ostrzeżenia zamiast błędów, pomijając inne źródła kanałów informacyjnych NuGet:

dotnet tool install -g --ignore-failed-sources upgrade-assistant