Dela via

Installera .NET Upgrade Assistant

I den här artikeln lär du dig hur du installerar .NET Upgrade Assistant med antingen Visual Studio-tillägget eller kommandoradsgränssnittet (CLI).

Viktigt!

Prova chattagenten för GitHub Copilot-appens modernisering. Den här agenten analyserar dina projekt och beroenden, skapar en stegvis migreringsplan med riktade rekommendationer och automatiserade kodkorrigeringar och genomför varje ändring så att du kan verifiera eller återställa. Den automatiserar vanliga portningsuppgifter – uppdatera projektfiler, ersätta inaktuella API:er och lösa byggproblem – så att du kan modernisera snabbare med mindre manuella åtgärder. Mer information finns i Vad är gitHub Copilot-appmodernisering.

Förutsättningar

Metoder

.NET Upgrade Assistant kan installeras som ett Visual Studio-tillägg eller som ett globalt .NET-verktyg.

Visual Studio-tillägget körs i Visual Studio på den lösning eller det projekt som du har öppnat. .NET Global Tool är ett interaktivt konsolprogram som körs på en lösning eller projektfil på eller under den aktuella katalogen.

Om du vill ha en smidig upplevelse av att öppna ett projekt i Visual Studio och uppgradera det installerar du tillägget.

Visual Studio-tillägg

Följande steg installerar Visual Studio-tillägget.

Dricks

Som ett alternativ till att använda funktionen Hantera tillägg i Visual Studio kan du ladda ned och köra installationsprogrammet för tillägg från Visual Studio Marketplace.

  1. Öppna Visual Studio.

    Om fönstret Öppna senaste \ Kom igång öppnas väljer du länken Fortsätt utan kod.

  2. Välj menyn Tillägg hantera>tillägg för att öppna fönstret Tilläggshanteraren.

  3. Välj fliken Bläddra.

  4. Skriv .NET-uppgraderingsassistenten i sökrutan.

  5. Välj objektet .NET Upgrade Assistant och välj sedan Installera.

    Fönstret Hantera tillägg i Visual Studio, som visar .NET Upgrade Assistant.

  6. När tillägget har laddats ned stänger du Visual Studio för att starta installationen automatiskt.

    En uppmaning om att installera tillägget .NET Upgrade Assistant.

  7. Välj Ändra och följ anvisningarna för att installera tillägget.

Verktyg för .NET Global

Följande steg installerar .NET Upgrade Assistant som ett globalt .NET-verktyg. .NET Upgrade Assistant distribueras i uppgraderingsassistentens NuGet-paket.

  1. Öppna en kommandotolk som har dotnet kommandot i Sökväg.

  2. Kör följande kommando för att installera verktyget:

    dotnet tool install -g upgrade-assistant

    Viktigt!

    Installationen av det här verktyget kan misslyckas om du har konfigurerat en annan NuGet-feedkälla. Använd parametern --ignore-failed-sources för att behandla dessa fel som varningar i stället för fel och kringgå de andra NuGet-feedkällorna:

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

Validering

Följande information hjälper dig att fastställa att .NET Upgrade Assistant är installerat.

  • Visual Studio-tillägg

    Det finns två sätt att avgöra om .NET Upgrade Assistant är installerat som ett Visual Studio-tillägg. Det snabbaste sättet är att högerklicka på ett .NET- eller .NET Framework-projekt i Solution Explorer-fönstret och söka efter menyalternativet Uppgradera .

    Ett annat sätt är att välja för att öppna > Välj sedan fliken Installerad och leta reda på den i listan över installerade tillägg.

  • .NET Global Tool

    Öppna en kommandotolk och kör upgrade-assistant kommandot. Om kommandosvaret anger att kommandot är okänt installerades inte verktyget korrekt eller finns inte i PATH.

Felsöka – .NET Global Tool

Om du har konfigurerat extra NuGet-feedkällor kan installationen misslyckas med ett fel som anger att NuGet-paketet inte är tillgängligt i feeden. Använd parametern --ignore-failed-sources för att behandla dessa fel som varningar i stället för fel, vilket kringgår de andra NuGet-feedkällorna:

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