Partilhar via

Atualizar projetos com o .NET Upgrade Assistant

  • Artigo

O foco deste artigo é fornecer as etapas básicas para atualizar um projeto com o .NET Upgrade Assistant. Isso envolve iniciar a atualização e revisar os resultados. Com base em quão complexo é o seu projeto, você pode ser obrigado a executar atualizações manuais para o seu código.

Alguns tipos de projetos têm orientações específicas sobre a atualização. Para obter mais informações, consulte Tipos de projeto suportados.

Pré-requisitos

Atualizar um projeto no Visual Studio

Siga estas etapas para atualizar um projeto no Visual Studio.

  1. Faça backup do seu código.

  2. Abra o Visual Studio.

  3. Abra um projeto ou solução.

  4. Na janela Gerenciador de Soluções, clique com o botão direito do mouse na Atualização do projeto>.

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

  5. Na guia Atualizar, selecione as opções de atualização apropriadas.

    Com base no tipo de projeto e na versão do quadro de destino, são apresentadas diferentes opções. A imagem a seguir mostra duas opções ao atualizar um projeto do Windows Forms para .NET Framework. Essas opções não são exibidas ao atualizar um projeto .NET:

    A tela de boas-vindas do Assistente de Atualização do .NET no Visual Studio.

    Neste exemplo, selecione Atualizar projeto para uma versão mais recente do .NET.

  6. Selecione como deseja executar a atualização. Selecione Atualização de projeto in-loco e, em seguida, selecione Avançar.

    Alguns projetos podem apresentar-lhe apenas uma única opção. Para obter mais informações sobre essas opções, consulte Como a atualização deve ser executada.

    O assistente do Assistente de Atualização do .NET mostrando a seleção 'Qual é o seu tipo de atualização'. 'Atualização de projeto in-loco' é realçado, assim como o botão 'Próximo'.

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

    O assistente do .NET Upgrade Assistant mostrando a seleção 'Qual é a sua estrutura de destino preferida'. '.NET 8.0' é realçado, assim como o botão 'Avançar'.

  8. Selecione os componentes a serem atualizados e, em seguida, selecione Seleção de atualização.

    O assistente do Assistente de Atualização do .NET mostrando a seleção 'Selecionar componentes para atualizar'. A lista de componentes é destacada, assim como o botão 'Seleção de atualização'.

  9. Quando a atualização estiver concluída, uma lista de itens processados será mostrada.

    O assistente de atualização do .NET mostrando a tela de resumo. Cada artefato processado pela atualização é listado, com um ícone de status.

Cada artefato processado pela atualização é listado, juntamente com seu status. Para obter mais informações, consulte Resultados da atualização.

Atualizar um projeto da CLI

Siga estas etapas para atualizar um projeto usando o terminal. A .NET Global Tool é uma ferramenta interativa que o orienta pelas opções de atualização. 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 a atualização.

  1. Faça backup do seu código.

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

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

    Você é perguntado sobre o que deseja atualizar. Dependendo do que for detetado, algumas opções podem ser aplicadas automaticamente ou totalmente ausentes.

    Um terminal mostrando a tela inicial de opções para a Ferramenta Global do Assistente de Atualização do .NET. A pergunta 'Qual projeto você quer atualizar' está sendo feita.

  4. Se mais de um projeto for encontrado, escolha um dos projetos e pressione Enter.

    Atualize os projetos na ordem de sua dependência. Por exemplo, a imagem anterior mostrava dois projetos: MatchingGame e MatchingGame.Logic. MatchingGame depende do MatchingGame.Logic, por isso MatchingGame.Logic deve ser atualizado primeiro.

  5. Se você tiver uma opção para alterar o tipo de atualização, escolha uma e pressione Enter. Se apenas uma opção estivesse disponível, ela teria sido selecionada automaticamente.

    Para obter mais informações sobre essas opções, consulte Como a atualização deve ser executada.

    Gorjeta

    Se você tiver feito backup do código, é seguro selecionar Atualização de projeto in-loco.

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

  7. O prompt final é uma confirmação, exibindo todas as opções selecionadas. Pressione Enter para iniciar a atualização.

    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.

  8. Quando a atualização terminar, um resumo será mostrado.

    Um terminal mostrando os resultados do comando upgrade ao usar a ferramenta global do .NET Upgrade Assistant.

Conteúdos relacionados