Condividi tramite

Installare .NET Upgrade Assistant

Questo articolo illustra come installare .NET Upgrade Assistant usando l'estensione di Visual Studio o lo strumento dell'interfaccia della riga di comando.

Importante

.NET Upgrade Assistant è ufficialmente deprecato. Usare invece l'agente di chat di modernizzazione di GitHub Copilot , incluso in Visual Studio 2026 e Visual Studio 2022 17.14.16 o versione successiva. Questo agente analizza i progetti e le dipendenze, produce un piano di migrazione dettagliato con raccomandazioni mirate e correzioni automatiche del codice e esegue il commit di ogni modifica in modo da poter convalidare o eseguire il rollback. Automatizza le attività di conversione comuni, ad esempio l'aggiornamento dei file di progetto, la sostituzione delle API deprecate e la risoluzione dei problemi di compilazione, in modo da poter modernizzare più velocemente con un lavoro meno manuale.

Prerequisiti

Metodi

.NET Upgrade Assistant può essere installato come estensione di Visual Studio o come strumento globale .NET.

L'estensione di Visual Studio viene eseguita all'interno di Visual Studio, nella soluzione o nel progetto aperto. Lo strumento globale .NET è un'applicazione console interattiva che viene eseguita in una soluzione o in un file di progetto alla o sotto la directory corrente.

Se si desidera un'esperienza semplificata di apertura e aggiornamento di un progetto in Visual Studio, installare l'estensione.

Estensione di Visual Studio

La procedura seguente consente di installare l'estensione di Visual Studio.

Suggerimento

In alternativa all'uso della funzionalità Gestisci Estensioni in Visual Studio, è possibile scaricare ed eseguire il programma di installazione delle estensioni dal Visual Studio Marketplace.

  1. Apri Visual Studio.

    Se viene visualizzata la finestra Apri recenti \ Iniziare, selezionare il collegamento Continua senza codice.

  2. Selezionare il menu Estensioni>Gestione estensioni per aprire la Finestra Gestore delle estensioni.

  3. Selezionare la scheda Sfoglia.

  4. Digitare .NET Upgrade Assistant nella casella di ricerca.

  5. Selezionare la voce Assistente di Aggiornamento .NET e quindi selezionare Installa.

    Finestra Gestisci estensioni in Visual Studio, che mostra l'Assistente aggiornamento .NET.

  6. Al termine del download dell'estensione, chiudere Visual Studio per avviare automaticamente l'installazione.

    Richiesta di installazione dell'estensione .NET Upgrade Assistant.

  7. Selezionare Modifica e seguire le istruzioni per installare l'estensione.

Strumento globale .NET

La procedura seguente consente di installare .NET Upgrade Assistant come strumento globale .NET. .NET Upgrade Assistant viene distribuito nel pacchetto NuGet di Upgrade Assistant.

  1. Aprire un prompt dei comandi che abbia il comando dotnet nel PATH.

  2. Eseguire il comando seguente per installare lo strumento:

    dotnet tool install -g upgrade-assistant

    Importante

    L'installazione di questo strumento potrebbe non riuscire se è stata configurata un'altra origine feed NuGet. Usare il --ignore-failed-sources parametro per considerare tali errori come avvisi anziché errori, ignorando le altre origini feed NuGet:

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

Convalida

Le informazioni seguenti consentono di determinare che è installato .NET Upgrade Assistant.

  • Estensione di Visual Studio

    Esistono due modi per determinare se .NET Upgrade Assistant è installato come estensione di Visual Studio. Il modo più rapido consiste nel fare clic con il pulsante destro del mouse su qualsiasi progetto .NET o .NET Framework nella finestra Esplora soluzioni e verificare la presenza di una voce di menu Aggiorna.

    Un altro modo consiste nel selezionare il menu Estensioni>Gestisci Estensioni per aprire la finestra Gestione Estensioni. Selezionare quindi la scheda Installato e trovarla nell'elenco delle estensioni installate.

  • Strumento globale .NET

    Aprire un prompt dei comandi ed eseguire il upgrade-assistant comando . Se la risposta del comando indica che il comando è sconosciuto, lo strumento non è stato installato correttamente o non è in PATH.

Risoluzione dei problemi - strumento globale .NET

Se sono state configurate origini di feed NuGet aggiuntive, l'installazione potrebbe non riuscire con un errore che indica che il pacchetto NuGet non è disponibile nel feed. Usare il --ignore-failed-sources parametro per considerare tali errori come avvisi anziché errori, ignorando le altre origini feed NuGet:

dotnet tool install -g --ignore-failed-sources upgrade-assistant
  • Last updated on