Instalar o Assistente de Atualização do .NET

  • Artigo

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

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 no projeto que você abriu. A Ferramenta Global do .NET é um aplicativo de console interativo que é executado em um arquivo de solução ou 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.

Dica

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 a guia Procurar.

  4. Digite assistente de atualização do .NET na caixa de pesquisa.

  5. Selecione o item Assistente de Atualização do .NET e, em seguida, selecione Instalar.

    A janela Gerenciar Extensões no Visual Studio, mostrando o Assistente de atualização do .NET.

  6. Depois que o download da extensão for concluído, feche o Visual Studio para iniciar automaticamente a instalação.

    Um prompt para instalar o Assistente de atualização do .NET.

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

Ferramenta global do .NET

As etapas a seguir instalam o Assistente de Atualização do .NET 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 Caminho.

  2. Execute o seguinte comando para instalar a ferramenta:

    dotnet tool install -g upgrade-assistant

    Importante

    A instalação dessa ferramenta poderá falhar se você tiver configurado outra fonte de feed NuGet. Use o --ignore-failed-sources parâmetro para tratar essas falhas como avisos em vez de erros, ignorando essas 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 Assistente de Atualização do .NET 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 Atualização.

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

  • Ferramenta global do .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 poderá 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