Perguntas frequentes sobre a modernização do aplicativo GitHub Copilot

Reconhecemos que o processo de migração é sempre complexo e entrelaçado, com diferentes camadas de ecossistemas de aplicativos. Neste momento, estamos limitando o escopo de migração para aplicativos de back-end Java. Damos suporte a projetos criados com o Maven ou o Gradle. Para obter informações sobre os principais recursos do produto, consulte a visão geral da modernização do aplicativo GitHub Copilot.

No momento, não temos planos de modernizar o aplicativo GitHub Copilot de software livre.

A modernização do aplicativo GitHub Copilot está disponível para o plano Pro, Pro+, Business ou Enterprise.

A modernização do aplicativo GitHub Copilot é um recurso do GitHub Copilot e compartilha o mesmo modelo de cobrança de assinatura que o GitHub Copilot. As tarefas de modernização de aplicativos consomem solicitações premium, com cada plano de assinatura oferecendo uma concessão mensal de solicitações premium. Exceder o limite do plano requer uma atualização de plano ou uma compra extra de solicitações premium.

Atualmente, a modernização do aplicativo GitHub Copilot está focada em ajudar com aplicativos Java e .NET. No entanto, estamos coletando ativamente requisitos e comentários dos clientes sobre a necessidade de dar suporte a outros idiomas.

No. A modernização do aplicativo GitHub Copilot usa o GitHub Copilot da mesma forma que você o usa para modificar o código, que não retém snippets de código além da sessão imediata. Também não coletamos, transmitimos ou armazenamos suas tarefas personalizadas.

As métricas de telemetria são coletadas e analisadas para acompanhar o uso e a eficácia do recurso.

Para obter mais informações, consulte a Declaração de Privacidade da Microsoft.

Testamos a modernização do aplicativo GitHub Copilot em centenas de repositórios de software livre para garantir que os testes de compilação, consistência e unidade sejam aprovados após o processo de modernização. Também trabalhamos extensivamente com clientes durante a fase de Visualização Técnica. A entrada dos usuários é usada para melhorar a experiência do produto. Você pode enviar comentários usando este link.

Embora a modernização do aplicativo GitHub Copilot se concentre na atualização de runtimes do Java, ela também otimiza atualizações para as seguintes estruturas:

• Spring Boot até a versão 3.5.
• Java EE – Javax para Jakarta EE, até Jakarta EE 10.
• Spring Framework herdado até a versão 6.2+.
• JUnit.
• Várias dependências de terceiros.

Para obter mais informações, consulte Personalizar o plano de atualização do projeto Java.

Atualmente, há suporte para as seguintes versões do JDK (Java Development Kit):

• JDK 8
• JDK 11
• JDK 17
• JDK 21
• JDK 25

A versão mínima necessária do JDK para um projeto é o JDK 8 e você pode atualizar o projeto para usar qualquer versão até o JDK 21.

Atualmente, há suporte apenas para os seguintes tipos de projeto:

• Projetos do Maven (incluindo o Wrapper do Maven)
• Projetos Gradle (somente Gradle Wrapper, versão 5+)

Não há suporte para projetos Gradle baseados em DSL do Kotlin.

Atualmente, a extensão tem as seguintes limitações funcionais:

• A extensão dá suporte exclusivamente a atualizações de Java e não atende a outras linguagens de programação.
• Ele funciona apenas com projetos Java criados usando Maven e Gradle.
• Há suporte apenas para repositórios Git. Outros sistemas de controle de versão não são compatíveis.
• A extensão não pode garantir que as alterações que ela propõe sejam ideais ou consideradas práticas recomendadas.

É recomendável usar as seguintes práticas recomendadas com esta ferramenta:

• Execute a extensão somente em projetos que atendam às características especificadas, conforme descrito anteriormente.
• Conclua revisões completas de código antes de mesclar a saída da extensão em branches de produção.
• Execute todos os testes e conclua as verificações de QUALIDADE usuais associadas ao processo de gerenciamento de alterações conforme apropriado.

Você pode usar a CLI do AppCAT para verificar vários projetos ao mesmo tempo usando o -bulk sinalizador. No entanto, recomendamos que você modernize apenas um projeto ou aplicativo por vez. Você pode criar sua própria tarefa de migração com base em alterações de código de um projeto e aplicá-las a outros projetos, reduzindo o trabalho repetitivo.

Como regra geral, os modelos mais recentes superam os modelos anteriores. Para tarefas de codificação, recomendamos modelos de Sonnet Claud para obter melhor precisão. No entanto, para reduzir o custo, considere iniciar a exploração de modelos com um multiplicador menor.

Para obter especificações detalhadas do modelo, consulte a documentação do GitHub Copilot.

Para garantir atualizações bem-sucedidas do runtime e da estrutura do Java, as seguintes informações são necessárias:

• O tipo de projeto. O projeto deve ser um projeto Java baseado em Git que pode ser compilado com Maven ou Gradle.
• A versão java de destino - a versão do JDK para a qual você deseja atualizar - por exemplo, Java 21.
• Os caminhos JDK de origem e de destino – os caminhos para os JDKs instalados para as versões atuais e de destino.
• A configuração do Maven/Gradle – caminhos para as ferramentas de build do Maven/Gradle. Para Gradle, há suporte apenas para wrappers Gradle.

A modernização do aplicativo GitHub Copilot usa o servidor MCP para aprimorar os recursos de transformação de código. Depois de instalar a extensão do Visual Studio Code, o servidor MCP será registrado e será iniciado automaticamente.

Se você observar um botão de atualização especial no canto inferior direito do painel de Chat do GitHub Copilot, poderá indicar que as atualizações de ferramenta estão disponíveis. Selecione o botão para carregar automaticamente as versões mais recentes das ferramentas.

O servidor MCP de modernização do aplicativo GitHub Copilot também mantém logs. Para solucionar problemas, verifique os arquivos de log localizados em: %USERPROFILE%/.ghcp-appmod-java/logs

Às vezes, a modernização do aplicativo GitHub Copilot requer confirmação explícita antes de continuar. Você pode digitar sim ou continuar no chat para permitir que o agente avance com as modificações de código.

Para garantir operações mais seguras, o agente do GitHub Copilot solicita repetidamente a confirmação do usuário, você pode usar a configuração a seguir como uma solução alternativa.

• Para o Visual Studio Code, você pode selecionar a seta suspensa ao lado do botão Continuar e, em seguida, selecionar Sempre Permitir ou atualizar sua configuração chat.tools.autoApprove do Visual Studio Code para true aprovar automaticamente todas as ferramentas. Também recomendamos configurar chat.agent.maxRequests para 128 reduzir o número de etapas que exigem confirmação para continuar.

  

• Para o Intellij IDEA, você pode selecionar o botão Continuar ou atualizar suas configurações, selecionar a janela de configuração doGitHub Copilot> e, em seguida, selecionar Aprovar automaticamente. Também recomendamos habilitar anotações da Ferramenta MCP de Confiança e aumentar as Solicitações Máximas para 99.

  

Para garantir que a extensão funcione corretamente no Visual Studio Code, a conectividade de rede deve ser estável e permitir o acesso aos serviços do GitHub Copilot. Em ambientes restritos, talvez seja necessário configurar regras de proxy ou firewall adequadamente. Se você encontrar erros como "Modelo de Linguagem Indisponível" na janela de chat, consulte o guia oficial de solução de problemas gerenciando o acesso do GitHub Copilot à rede da sua empresa.

O GitHub Copilot pode bloquear determinadas gerações de código para arquivos que geralmente se assemelham a código público, como pom.xml. Para impedir que o Copilot bloqueie essas alterações, você deve permitir sugestões correspondentes ao código público. Para obter instruções, consulte Habilitar ou desabilitar sugestões correspondentes ao código público.

Para gerenciar as configurações do GitHub Copilot em sua organização, consulte Habilitar recursos do Copilot em sua organização.

A modernização do aplicativo GitHub Copilot usa o servidor MCP para fornecer funcionalidades de migração especializadas. Quando você seleciona Atualizar, ele estabelece uma conexão com esse servidor e atualiza as ferramentas disponíveis no agente de chat. Essa ação só é necessária nos seguintes casos:

• Quando você abre um projeto Java para migração pela primeira vez.
• Quando você atualiza a extensão para uma versão mais recente.

A modernização do aplicativo GitHub Copilot é alimentada pela IA, portanto, erros ocasionais podem ocorrer. Sempre examine a saída cuidadosamente antes do uso. Você também pode repetir o processo de regeneração para ver sugestões de código alternativas.

As tarefas predefinidas estão no seguinte local: %USERPROFILE%.vscode\extensions\microsoft.migrate-java-to-azure-0.1.0\rag

As tarefas personalizadas estão no seguinte local: %USERPROFILE%.azure\migrate-copilot\custom-rule

O agente sempre inclui explicações para suas alterações de código na janela de chat. No entanto, esses detalhes podem ser recolhidos na interface do usuário. Você pode expandir a resposta no chat para ver a lógica completa e o raciocínio passo a passo.

Atualmente, só oferecemos suporte a plataformas Windows e macOS.