Condividi tramite

Installare .NET Upgrade Assistant

Questo articolo illustra come installare .NET Upgrade Assistant in Visual Studio o usando 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 è integrato in Visual Studio o può essere installato come strumento globale .NET.

L'Assistente di aggiornamento viene eseguito in Visual Studio, nella soluzione o nel progetto che hai 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 vuole un'esperienza semplificata di apertura di un progetto in Visual Studio e l'aggiornamento, usare Assistente aggiornamento.

Visual Studio

La seguente procedura abilita l'Assistente aggiornamento legacy in Visual Studio.

  1. Apri Visual Studio.

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

  2. Selezionare il menu Opzioni strumenti>, che apre la finestra Opzioni.

  3. Naviga a Tutte le Impostazioni>Progetti e Soluzioni>Modernizzazione.

  4. Selezionare la voce Abilita Upgrade Assistant legacy.

  5. Riavviare Visual Studio

    Screenshot che mostra la finestra delle opzioni in Visual Studio con la pagina Impostazioni di modernizzazione aperta.

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.

  • Visual Studio

    Per determinare se l'Assistente aggiornamento .NET è abilitato, 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 .

  • 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