Partilhar via

Analise projetos com o .NET Upgrade Assistant

Este artigo ensina como executar a análise de código em seus projetos com o Assistente de Atualização do .NET, usando o Visual Studio ou o terminal. A análise gera um relatório que você pode navegar para obter mais informações sobre a atualização.

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

Criar um relatório no Visual Studio

Siga estas etapas para analisar um projeto no Visual Studio.

  1. Abra o Visual Studio.

  2. Abra um projeto ou solução.

  3. Na janela Gerenciador de Soluções, clique com o

    A janela Gerenciador de Soluções no Visual Studio, mostrando o menu do botão direito do mouse da solução. O item de menu Atualizar é realçado.

  4. Na guia Assistente de Atualização: Página Inicial , selecione Novo Relatório.

    A página de boas-vindas do assistente de Análise do Assistente de Atualização do .NET no Visual Studio. A ligação «Novo Relatório» está em destaque.

  5. Selecione um ou mais projetos para analisar e, em seguida, selecione Avançar.

    A página 'Selecionar projetos' do assistente de atualização do .NET Analyze no Visual Studio. A lista de projetos é destacada juntamente com o botão «Seguinte».

  6. Selecione a estrutura de destino, por exemplo .NET 8.0. Em seguida, selecione Seguinte.

    A página 'Estrutura de destino' do assistente de análise do Assistente de Atualização do .NET no Visual Studio. O item '.NET 8.0' é realçado juntamente com o botão 'Seguinte'.

  7. Selecione os componentes a serem analisados e, em seguida, selecione Avançar.

    A página 'Configurações de análise' do assistente de atualização do .NET Upgrade Assistant Analyze no Visual Studio. A opção 'Código fonte e configurações' está selecionada. O botão 'Seguinte' está realçado.

  8. Um indicador de progresso é exibido para cada projeto que está sendo analisado.

    O assistente de Análise do Assistente de Atualização do .NET executando a análise.

  9. Quando a análise estiver concluída, o painel do relatório será mostrado. Para obter mais informações sobre o painel, consulte Relatórios.

    O assistente de Análise do Assistente de Atualização do .NET mostrando um painel de relatório que contém os resultados da análise.

Criar um relatório a partir da CLI

Siga estas etapas para analisar um projeto usando o terminal. A .NET Global Tool é uma ferramenta interativa que o orienta pelas opções de análise. Use as teclas de seta para cima e seta para baixo para alterar a opção realçada e Enter para executar a seleção da opção. Cada tela apresenta opções sobre como você deseja configurar o relatório.

  1. Abra um terminal e navegue até a pasta que contém a solução ou projeto que você deseja analisar.

  2. Para iniciar a ferramenta, execute o upgrade-assistant analyze comando.

  3. Você é questionado sobre o que deseja analisar. Para este exemplo, escolha Fontes de aplicativo e pressione Enter.

    Um terminal mostrando a tela inicial de opções para a Ferramenta Global do Assistente de Atualização do .NET. Está a ser feita a pergunta

  4. Escolha uma estrutura de destino, como .NET 8.0, e pressione Enter.

  5. Selecione os tipos de itens que deseja digitalizar. Use a Barra de espaço para alternar as opções e pressione Enter.

  6. Na tela Arquivo de configuração, pressione n, a menos que você tenha um arquivo de configuração de conjunto de regras para aplicar.

  7. Escolha o formato do relatório gerado. Para os fins deste exemplo, selecione Salvar como HTML.

  8. Digite o nome MyReport e pressione Enter.

  9. Selecione o modo de privacidade apropriado, como Restrito, e pressione Enter.

  10. O prompt final é uma confirmação, exibindo todas as opções selecionadas. Pressione Enter para executar a análise e gerar o relatório.

    Um terminal mostrando a tela de resumo das opções para a Ferramenta Global do Assistente de Atualização do .NET. O usuário é solicitado a continuar.

  11. Quando o relatório terminar, um resumo do relatório será exibido. Os resultados do relatório são salvos na pasta do projeto ou solução que foi analisada.

    Um terminal mostrando os resultados do comando de análise ao usar a Ferramenta Global do Assistente de Atualização do .NET.

Conteúdos relacionados

  • Last updated on