Udostępnij przez

Instalowanie Asystenta uaktualniania platformy .NET

W tym artykule przedstawiono sposób instalowania Asystenta uaktualniania platformy .NET przy użyciu rozszerzenia programu Visual Studio lub narzędzia interfejsu wiersza polecenia.

Ważne

Asystent uaktualnienia platformy .NET jest oficjalnie przestarzały. Zamiast tego użyj agenta czatu modernizacji aplikacji GitHub Copilot , który jest dołączony do programów Visual Studio 2026 i Visual Studio 2022 17.14.16 lub nowszych. 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

Metody

Asystent uaktualnienia platformy .NET można zainstalować jako rozszerzenie programu Visual Studio lub jako narzędzie globalne platformy .NET.

Rozszerzenie programu Visual Studio działa w programie Visual Studio w otwartym rozwiązaniu lub projekcie. Narzędzie globalne platformy .NET to interaktywna aplikacja konsolowa uruchamiana w pliku rozwiązania lub projektu pod bieżącym katalogiem.

Jeśli chcesz usprawnić środowisko otwierania projektu w programie Visual Studio i uaktualniania go, zainstaluj rozszerzenie.

Rozszerzenie programu Visual Studio

Poniższe kroki umożliwiają zainstalowanie rozszerzenia programu Visual Studio.

Napiwek

Alternatywą dla korzystania z funkcji Zarządzanie rozszerzeniami w programie Visual Studio jest pobranie i uruchomienie instalatora rozszerzeń z witryny Visual Studio Marketplace.

  1. Otwórz program Visual Studio.

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

  2. , aby otworzyć > rozszerzeń.

  3. Wybierz kartę Przeglądaj.

  4. Wpisz asystenta uaktualniania platformy .NET w polu wyszukiwania.

  5. Wybierz element Asystenta uaktualniania platformy .NET, a następnie wybierz pozycję Zainstaluj.

    Okno zarządzanie rozszerzeniami w programie Visual Studio z wyświetlonym asystentem uaktualniania platformy .NET.

  6. Po zakończeniu pobierania rozszerzenia zamknij program Visual Studio, aby automatycznie uruchomić instalację.

    Monit o zainstalowanie rozszerzenia asystenta uaktualniania platformy .NET.

  7. Wybierz pozycję Modyfikuj i postępuj zgodnie z instrukcjami, aby zainstalować rozszerzenie.

Narzędzie globalne platformy .NET

Poniższe kroki umożliwiają zainstalowanie asystenta uaktualniania platformy .NET jako narzędzia globalnego platformy .NET. Asystent uaktualnienia platformy .NET jest dystrybuowany w pakiecie NuGet asystenta uaktualniania.

  1. Otwórz wiersz polecenia z poleceniem dotnet w ścieżce.

  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.

  • Rozszerzenie programu Visual Studio

    Istnieją dwa sposoby określania, czy asystent uaktualnienia platformy .NET jest zainstalowany jako rozszerzenie programu Visual Studio. Najszybszym sposobem jest kliknięcie prawym przyciskiem myszy dowolnego projektu .NET lub .NET Framework w oknie Eksplorator rozwiązań i sprawdzenie elementu menu Uaktualnianie.

    Innym sposobem jest wybranie , > rozszerzeń. Następnie wybierz kartę Zainstalowane i znajdź ją na liście zainstalowanych rozszerzeń.

  • 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
  • Last updated on