Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este FAQ responde a dúvidas comuns que usuários de C++ podem ter sobre a modernização com o GitHub Copilot.
Geral
O que é a modernização para C++ do GitHub Copilot?
A modernização de C++ com o GitHub Copilot é um agente do GitHub Copilot para o Visual Studio que ajuda você a modernizar e atualizar projetos em C++ para ferramentas, bibliotecas e padrões mais modernos. Ele reconhece tarefas específicas, como atualizar as Ferramentas de Build do MSVC para versões mais recentes e fornece ferramentas e instruções adicionais para realizar essas tarefas. Ele automatiza a avaliação, o planejamento e a execução para realizar a tarefa de modernização e você pode executá-la em um modo totalmente automatizado ou em um modo guiado que permite aprovar cada etapa e fornecer diretrizes adicionais.
Quais ambientes de desenvolvimento têm suporte?
A modernização para C++ do GitHub Copilot está disponível no Visual Studio 2026, versão 18.7 ou posterior.
Preciso de uma assinatura GitHub Copilot?
Sim. Você precisa de uma assinatura GitHub Copilot ativa para usar o agente de modernização.
Meu código é enviado para serviços externos?
GitHub Copilot processa trechos de código de acordo com a política de privacidade do GitHub Copilot. O código não é mantido além da sessão imediata. Arquivos de fluxo de trabalho, como scenario-instructions.md e tasks.md permanecer em seu repositório e não são transmitidos para serviços externos.
Cenários de atualização do MSVC
Quais tipos de projeto têm suporte?
O agente dá suporte a esses tipos de projeto:
- Projetos baseados em MSBuild (
.slne.vcxproj). - Projetos baseados em CMake.
Atualmente, o agente não oferece suporte a projetos do Unreal Engine (.uproject).
O que o agente realmente muda no meu código?
O agente modifica o código-fonte para resolver erros de build e avisos introduzidos pela atualização para uma versão mais recente das Ferramentas de Build do MSVC. As alterações comuns incluem a substituição de APIs preteridas, a correção de problemas causados pelo uso de um compilador mais compatível, a atualização de diretivas de inclusão para cabeçalhos removidos ou realocados e a resolução de erros de vinculador causados por alterações de biblioteca. Quando o projeto está em um repositório git, todas as alterações são confirmadas para que você possa examinar e reverter modificações individuais.
Posso controlar o que o agente muda?
Sim. Você pode examinar e aprovar o plano antes do início da execução, dizer ao agente para ignorar problemas ou tarefas específicas e fornecer preferências em scenario-instructions.md. Você também pode pausar a execução, redirecionar o agente ou reverter qualquer commit que ele fizer.
O agente executa testes?
O agente valida as alterações criando o projeto após cada tarefa. Se o projeto executar testes como parte do build, esses testes também são executados. Você também pode dizer ao agente para ignorar a validação de testes para tarefas específicas.
E se o agente cometer um erro?
Pare o agente e diga isso imediatamente. Ele adaptará e aplicará correções quando você pedir ao agente para retomar. Você também pode executar git revert HEAD, pedir ao agente para tentar uma abordagem diferente ou fazer uma correção manual.
Para obter mais informações, consulte Solucionar problemas na modernização com o GitHub Copilot para C++.
Posso atualizar apenas parte da minha solução?
Sim. Informe ao agente quais projetos atualizar, por exemplo, Upgrade only the CoreLib project to the latest MSVC Build Tools. O agente limita seu trabalho aos projetos que você especificar.
Estado e sessões
Onde o agente armazena seu estado?
Todo o estado reside dentro de .github/upgrades/{SCENARIO ID} no seu repositório. Isso inclui a avaliação, o plano, o progresso da tarefa, suas preferências e os logs de execução.
Posso retomar uma atualização interrompida?
Sim. Você pode fechar Visual Studio ou encerrar a sessão de chat a qualquer momento. Quando você inicia uma nova conversa, o agente detecta o estado existente e continua de onde parou.
Devo confirmar a .github/upgrades pasta?
Sim. Confirmar a pasta no branch faz backup do progresso da atualização, permite que os membros da equipe exibam o estado de atualização e ajuda o agente a retomar do estado correto. Você pode remover a pasta após a conclusão da atualização.
Várias pessoas podem trabalhar na mesma atualização?
Os arquivos de estado em .github/upgrades podem ser compartilhados via Git. No entanto, apenas uma pessoa deve interagir ativamente com o agente de cada vez para evitar alterações conflitantes.
Compatibility
De quais versões do MSVC Build Tools posso atualizar?
O agente dá suporte à atualização de qualquer versão anterior das Ferramentas de Build do MSVC para a versão mais recente compatível com a instalação do Visual Studio.
O agente lida com a compatibilidade da biblioteca de terceiros?
O agente identifica problemas de compatibilidade de biblioteca de terceiros durante a avaliação. Ele sugere alternativas ou soluções alternativas quando estão disponíveis. Se uma biblioteca não for compatível com o conjunto de ferramentas de destino, o agente documentará o problema para que você possa decidir como proceder.
Posso usar o agente com cabeçalhos pré-compilados?
Sim. O agente entende as configurações de cabeçalhos pré-compilados e as leva em consideração durante o processo de atualização.