Instalar o Assistente de Atualização do .NET

O Assistente de atualização do .NET pode ser instalado como uma extensão do Visual Studio ou como uma ferramenta de linha de comando do .NET. Quando instalados como uma extensão do Visual Studio, os projetos carregados podem ser atualizados por meio do menu de contexto. A versão da ferramenta de linha de comando do .NET da ferramenta fornece uma experiência passo a passo interativa. Para obter mais informações sobre a ferramenta, consulte Visão geral do Assistente de Atualização do .NET.

Pré-requisitos

Instale a extensão do Visual Studio

O Assistente de atualização do .NET pode ser instalado como uma extensão do Visual Studio, que permite atualizar um projeto aberto. Use as etapas a seguir para instalar o Assistente de atualização do .NET dentro do Visual Studio. Como alternativa, você pode baixar e instalar a extensão do Visual Studio Marketplace.

  1. Com o Visual Studio aberto, pressione o item de menu Extensões>Gerenciar Extensões, que abre a janela Gerenciar Extensões .

  2. Na janela Gerenciar Extensões, insira atualizar na caixa de entrada de pesquisa.

  3. Selecione o item Assistente de atualização do .NET e Baixar.

    The manage extensions window in Visual Studio, showing the .NET Upgrade Assistant.

  4. Depois que a extensão tiver sido baixada, feche o Visual Studio. Isso inicia a instalação da extensão:

    A prompt to install the .NET Upgrade Assistant extension.

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

Instalar a ferramenta global do .NET

O Assistente de atualização do .NET também está disponível como uma ferramenta global do .NET. Você pode instalar a ferramenta com o seguinte comando:

dotnet tool install -g upgrade-assistant

De modo semelhante, como o Assistente de atualização do .NET é instalado como uma ferramenta .NET, ele pode ser facilmente atualizado executando:

dotnet tool update -g upgrade-assistant

Importante

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

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

Para atualizar projetos com componentes do WCF, use a versão mais antiga da ferramenta da CLI. Para saber mais, confira Instalação (versão herdada).