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).

Pré-requisitos

• Sistema operacional Windows
• Visual Studio 2022 versão 17.1 ou mais recente.
• .NET SDK 8 ou posterior.

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.

   

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

   

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