Usando a modernização do aplicativo GitHub Copilot para C++

A modernização do aplicativo GitHub Copilot para C++ ajuda você a atualizar projetos C++ para versões mais recentes do MSVC Build Tools. Se necessário, o Copilot atualizará as configurações do projeto para usar o MSVC mais recente e, em seguida, realizará uma avaliação completa do impacto dessas alterações após a execução de um build. Ele desenvolve um plano sobre como resolver cada problema identificado. Depois que você aprova o plano, o agente conclui uma sequência de tarefas e valida que todas as alterações resolveram os problemas identificados. Se ainda houver trabalho a ser feito, o agente continuará iterando até que os problemas sejam resolvidos ou você descontinue a conversa.

Observação

A modernização do aplicativo GitHub Copilot para C++ está atualmente em versão prévia.

Requirements

• Visual Studio 2026 versão 18.3 ou posterior
• Uma conta do GitHub Copilot
• Uma base de código baseada em MSBuild (.sln, .vcxproj) OU uma base de código baseada em CMake

Habilitar a modernização do aplicativo GitHub Copilot para C++

A modernização do aplicativo GitHub Copilot para C++ está habilitada por padrão. Para desabilitar ou habilitar explicitamente o recurso, siga estas etapas.

1. No Visual Studio, selecione Opções de Ferramentas > ... para abrir a janela Opções .
2. Navegue até Todas as Configurações > do GitHub > Copilot > C/C++.
3. Selecione (para habilitar) ou desmarque (para desabilitar) a caixa de seleção para habilitar a modernização do aplicativo GitHub Copilot para C++ (versão prévia).
4. Reinicie o Visual Studio para que a alteração de configuração entre em vigor.

Atualizar sua base de código usando a modernização do aplicativo GitHub Copilot para C++

Esta seção descreve como iniciar o agente modernizar e os estágios pelos quais ele passa para atualizar sua base de código.

Iniciar o agente de modernização

A funcionalidade de modernização do aplicativo GitHub Copilot é um agente que opera dentro da janela do GitHub Copilot Chat. Você pode iniciar o agente de qualquer uma das seguintes maneiras:

• No menu de contexto do Gerenciador de Soluções: clique com o botão direito do mouse na solução ou em um projeto carregado no Gerenciador de Soluções e escolha Modernizar no menu de contexto. Isso inicia automaticamente uma janela do GitHub Copilot Chat, ativa o agente Modernizar e fornece prompts relevantes para você escolher e começar.

• Do GitHub Copilot Chat: Abra a janela do GitHub Copilot Chat selecionando Exibir > GitHub Copilot Chat. Depois que a janela do GitHub Copilot Chat for aberta, mencione @Modernize em um prompt para ativar o agente Modernize. Por exemplo, digite este prompt:

  Use @Modernize to update MSVC Build Tools.

Para bases de código que utilizam MSBuild que visam uma versão anterior das Ferramentas de Build do MSVC

Na primeira vez que você carregar um .vcxproj projeto direcionado a uma versão anterior das Ferramentas de Build do MSVC, você verá uma opção para atualizar as configurações do projeto para usar uma versão mais recente das Ferramentas de Build do MSVC. Se você redirecionar qualquer um de seus projetos para uma nova versão das Ferramentas de Build do MSVC e a modernização do aplicativo GitHub Copilot para C++ estiver habilitada, você receberá uma barra de informações no Visual Studio solicitando que você use a modernização do aplicativo GitHub Copilot para C++ para resolver problemas de build recém-introduzidos. Selecionar Executar a modernização do aplicativo GitHub Copilot para C++ inicia a janela do GitHub Copilot Chat, ativa o agente Modernizar e fornece prompts relevantes para escolher para começar.

Iniciar a atualização

Depois que o agente Modernize estiver ativo, você poderá instruí-lo por meio de um prompt a atualizar suas MSVC Build Tools ou selecionar o prompt já construído na lista exibida na janela. Se você iniciou o agente diretamente na janela do GitHub Copilot Chat mencionando @Modernize em seu prompt, provavelmente não precisará fornecer mais solicitações.

Projetos do MSBuild

Projetos do CMake

Estágio de avaliação

O agente primeiro avalia quais tipos de problemas aparecem após a atualização. Se você ainda não atualizou o projeto, o agente orientará você nesse processo antes de criar sua avaliação. Depois de garantir que seu projeto seja atualizado, o agente cria sua base de código, analisa os avisos e erros relatados e gera um assessment.md arquivo que descreve os problemas encontrados, sua gravidade e outras informações úteis. Essa é a sua oportunidade de informar ao agente qualquer outro contexto que possa ajudá-lo a fazer um plano.

Uma das coisas que você pode escolher fazer aqui é dizer ao agente para não corrigir determinados problemas descobertos, porque você sabe que resolvê-los envolve algumas decisões estratégicas ou porque eles eram avisos pré-existentes que você decidiu serem aceitáveis para o seu projeto. Você deve ler cuidadosamente o plano, certificando-se de fornecer esse contexto extra onde ele é necessário. Depois de aprovar a avaliação, o agente passará a criar um plano concreto para resolver os problemas.

Estágio de planejamento

Com base na avaliação aprovada e em qualquer outro contexto ou instruções fornecidas, o agente cria um plan.md arquivo que propõe um plano detalhado para resolver cada um dos problemas identificados. Se o agente produzir um plano que não corresponda ao estilo ou práticas de codificação da sua organização, você poderá fornecer essas diretrizes ao agente e fazer com que ele resolva o problema de forma diferente. Depois que você concordar com o plano, o agente passará para o estágio de execução.

Estágio de execução

Agora que o agente tem um plano, ele divide as tarefas necessárias para executar o plano. Você pode definir essas tarefas da maneira mais adequada que desejar. As tarefas podem até incluir etapas para trabalhar em um ramo ou agrupar alterações específicas em um único commit. Depois de fazer alterações, o agente cria o projeto novamente para confirmar se os problemas foram resolvidos. Se os problemas não forem resolvidos, o agente itera com você até que eles sejam resolvidos para sua satisfação.

Validação pós-atualização

Quando o agente terminar, execute as alterações em qualquer infraestrutura de teste que você tenha. Fazer com que um colega examine as alterações em uma solicitação de pull. Como esse recurso está atualmente em versão prévia, você pode receber uma barra de informações para concluir uma pesquisa de produto para permitir que a equipe do produto saiba como o agente foi executado em sua base de código. A equipe de produtos espera ouvir como pode melhorar o agente para resolver seus problemas e acelerar seus esforços de atualização e modernização.