Installera .NET Upgrade Assistant

I den här artikeln lär du dig hur du installerar .NET Upgrade Assistant i Visual Studio eller använder kommandoradsgränssnittsverktyget (CLI).

Viktigt!

.NET Upgrade Assistant är officiellt inaktuell. Använd GitHub Copilot-moderniseringschattagenten i stället, som ingår i Visual Studio 2026 och Visual Studio 2022 17.14.16 eller senare. 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.

Förutsättningar

Metoder

.NET Upgrade Assistant är inbyggt i Visual Studio eller kan installeras som ett globalt .NET-verktyg.

Uppgraderingsassistenten 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 den smidiga upplevelsen av att öppna ett projekt i Visual Studio och uppgradera det använder du uppgraderingsassistenten.

Visual Studio

Följande steg aktiverar den äldre uppgraderingsassistenten i Visual Studio.

  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 Verktygsalternativ>, som öppnar fönstret Alternativ.

  3. Gå till Alla inställningar>Projekt och Lösningar>Modernisering.

  4. Välj objektet Aktivera äldre uppgraderingsassistent .

  5. Starta om Visual Studio

    En skärmbild som visar alternativfönstret i Visual Studio med sidan Moderniseringsinställningar öppen.

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

    Om du vill ta reda på om .NET Upgrade Assistant är aktiverat högerklickar du på ett .NET- eller .NET Framework-projekt i Solution Explorer-fönstret och söker efter ett menyalternativ för Uppgradering .

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