Compartilhar via

Atualizar projetos com o Assistente de Atualização do .NET

  • Artigo

O foco deste artigo é fornecer as etapas básicas para atualizar um projeto com o Assistente de Atualização do .NET. Isso envolve iniciar a atualização e revisar os resultados. Com base na complexidade do seu projeto, pode ser necessário executar atualizações manuais no código.

Alguns tipos de projeto têm diretrizes específicas sobre atualização. Para obter mais informações, consulte Tipos de projeto com suporte.

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 de clique com o 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 da estrutura de destino, diferentes opções são apresentadas. 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 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' é destacado, assim como o botão 'Avançar'.

  7. Selecione a estrutura de destino, por exemplo , .NET 8.0. Em seguida, selecione Avançar.

    O assistente do Assistente de Atualização do .NET mostrando a seleção 'Qual é sua estrutura de destino preferencial'. '.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 'Atualizar seleção'.

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

    O assistente do 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 Ferramenta Global do .NET é uma ferramenta interativa que orienta você pelas opções de atualização. Use as teclas de seta para cima e para baixo para alterar a opção realçada e Enter para executar a opção de seleçã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 o projeto que você deseja atualizar.

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

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

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

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

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

  5. Se você tiver a opção de 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.

    Dica

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

  6. Escolha uma estrutura de destino, como o .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 que mostra a tela de resumo das opções da Ferramenta Global do Assistente de Atualização do .NET. O usuário é solicitado a continuar.

  8. Quando a atualização for concluída, um resumo será exibido.

    Um terminal que mostra os resultados do comando de atualização ao usar a Ferramenta Global do Assistente de Atualização do .NET.

Conteúdo relacionado