Partilhar via

Instalar o Assistente de Atualização do .NET

Este artigo ensina como instalar o Assistente de Atualização do .NET usando a extensão do Visual Studio ou a ferramenta de interface de linha de comando (CLI).

Importante

O .NET Upgrade Assistant foi oficialmente preterido. Em vez disso, use o agente de chat de modernização do aplicativo GitHub Copilot , que está incluído no Visual Studio 2026 e no Visual Studio 2022 17.14.16 ou posterior. Esse agente analisa seus projetos e dependências, produz um plano de migração passo a passo com recomendações direcionadas e correções de código automatizadas e confirma cada alteração para que você possa validar ou reverter. Ele automatiza tarefas comuns de portabilidade — atualizando arquivos de projeto, substituindo APIs preteridas e resolvendo problemas de compilação — para que você possa se modernizar mais rapidamente com menos esforço manual.

Pré-requisitos

Métodos

O Assistente de Atualização do .NET pode ser instalado como uma extensão do Visual Studio ou como uma Ferramenta Global do .NET.

A extensão do Visual Studio é executada dentro do Visual Studio, na solução ou projeto aberto. A .NET Global Tool é um aplicativo de console interativo que é executado em uma solução ou arquivo de projeto no diretório atual ou abaixo dele.

Se você quiser a experiência simplificada de abrir um projeto no Visual Studio e atualizá-lo, instale a extensão.

Extensão do Visual Studio

As etapas a seguir instalam a extensão do Visual Studio.

Gorjeta

Como alternativa ao uso do recurso Gerenciar Extensões do Visual Studio, você pode baixar e executar o instalador de extensões do Visual Studio Marketplace.

  1. Abra o Visual Studio.

    Se a janela Abrir recente \ Introdução for aberta, selecione o link Continuar sem código .

  2. Selecione o menu Extensões Gerenciar extensões para abrir a janela Gerenciador de extensões>.

  3. Selecione o separador Procurar.

  4. Digite .NET upgrade assistant na caixa de pesquisa.

  5. Selecione o item .NET Upgrade Assistant e, em seguida, selecione Instalar.

    A janela gerenciar extensões no Visual Studio, mostrando o Assistente de Atualização do .NET.

  6. Quando o download da extensão terminar, feche o Visual Studio para iniciar automaticamente a instalação.

    Um prompt para instalar a extensão do .NET Upgrade Assistant.

  7. Selecione Modificar e siga as instruções para instalar a extensão.

Ferramenta Global .NET

As etapas a seguir instalam o .NET Upgrade Assistant como uma ferramenta global do .NET. O Assistente de Atualização do .NET é distribuído no pacote NuGet do assistente de atualização.

  1. Abra um prompt de comando que tenha o dotnet comando em Path.

  2. Execute o seguinte comando para instalar a ferramenta:

    dotnet tool install -g upgrade-assistant

    Importante

    A instalação dessa ferramenta pode falhar se você tiver configurado outra fonte de feed do NuGet. Use o --ignore-failed-sources parâmetro para tratar essas falhas como avisos em vez de erros, ignorando as outras fontes de feed do NuGet:

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

Validação

As informações a seguir ajudam a determinar se o .NET Upgrade Assistant está instalado.

  • Extensão do Visual Studio

    Há duas maneiras de determinar se o Assistente de Atualização do .NET está instalado como uma extensão do Visual Studio. A maneira mais rápida é clicar com o botão direito do mouse em qualquer projeto .NET ou .NET Framework na janela Gerenciador de Soluções e verificar se há um item de menu Atualizar.

    Outra maneira é selecionar o menu Extensões>gerenciar extensões para abrir a janela Gerenciador de extensões. Em seguida, selecione a guia Instalado e encontre-a na lista de extensões instaladas.

  • Ferramenta Global .NET

    Abra um prompt de comando e execute o upgrade-assistant comando. Se a resposta do comando indicar que o comando é desconhecido, a ferramenta não foi instalada corretamente ou não está no PATH.

Solução de problemas - .NET Global Tool

Se você configurou fontes de feed NuGet extras, a instalação pode falhar com um erro indicando que o pacote NuGet não está disponível no feed. Use o --ignore-failed-sources parâmetro para tratar essas falhas como avisos em vez de erros, ignorando as outras fontes de feed do NuGet:

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