Guia Rápido: Atualização de um projeto de Java com modernização utilizando o GitHub Copilot

A modernização com o GitHub Copilot oferece uma experiência agêntica com tecnologia de IA que automatiza fluxos de trabalho de atualização de Java de ponta a ponta — da análise do projeto e da geração de planos à transformação de código, validação da compilação e remediação de CVEs.

Cenários de atualização com suporte

  • Atualize Java Kit de Desenvolvimento (JDK) para Java 11, 17, 21 ou 25.
  • Atualize o Spring Boot para a versão 4.0.
  • Atualize o Spring Framework para a versão 7.x.
  • Atualize Java EE para Jakarta EE até Jakarta EE 11.
  • Atualizar SDK do Azure para Java.
  • Atualizar o JUnit.
  • Atualize dependências de terceiros para uma versão especificada.

Pré-requisitos

  • Uma conta GitHub com GitHub Copilot habilitado. Você precisa de um plano Gratuito, Pro, Pro+, Business ou Enterprise.
  • Java JDK para as versões do JDK de origem e de destino.
  • Maven ou Gradle para criar projetos Java.
  • Um projeto de Java gerenciado pelo Git usando o Maven ou o Gradle.
  • Para projetos baseados em Maven: acesso ao repositório público do Maven Central.

  • Instale a CLI GitHub Copilot:

    npm install -g @github/copilot

  • Instale o plug-in de modernização do GitHub Copilot:

    copilot plugin marketplace add microsoft/modernize-java
copilot plugin install modernize-java@modernize-java

Observação

Uma conta do Azure é necessária apenas para implantar recursos no Azure e não é necessária ao usar a modernização com o GitHub Copilot para fazer alterações de código.

Se você estiver usando o Gradle, somente o wrapper Gradle versão 5 ou posterior terá suporte.

Não há suporte para a DSL (Linguagem Específica do Domínio Kotlin).

Selecione um projeto de Java para atualizar

Para este tutorial, escolha um dos seguintes repositórios de exemplo:

Iniciar a atualização

Use as seguintes etapas para iniciar o processo de atualização:

  1. Abra o projeto de Java selecionado no Visual Studio Code.

  2. Na barra lateral, abra o painel modernização do GitHub Copilot para ver a página Início rápido.

  3. Selecione Atualização do Java Runtime e Estruturas.

    Essa ação abre o GitHub Copilot Chat no modo de agente e inicia automaticamente o processo de atualização.

    Dica

    Você também pode selecionar uma tarefa específica na árvore Tarefas abaixo do painel Início Rápido (por exemplo, Atualizar versão do Spring Boot ou atualizar a versão do Jakarta EE) para disparar uma atualização direcionada.

    Como alternativa, você pode digitar diretamente no GitHub Copilot Chat usando o modo de agente - por exemplo, "Atualizar meu projeto de Java para Java 21" - para iniciar a atualização.

Captura de tela do Visual Studio Code que mostra a página Início Rápido com o botão Upgrade Java Runtime & Frameworks.

Use as seguintes etapas para iniciar o processo de atualização:

  1. Abra o projeto de Java selecionado no IntelliJ IDEA.

  2. Na barra lateral, abra o painel GitHub Copilot modernization para ver a página de Início Rápido.

  3. Selecione Atualizar Runtime &Frameworks.

    Essa ação abre o GitHub Copilot Chat no modo de agente e inicia automaticamente o processo de atualização.

    Dica

    Você também pode digitar diretamente no GitHub Copilot Chat usando o modo de agente - por exemplo, "Atualizar meu projeto de Java para Java 21" - para iniciar a atualização.

Captura de tela do IntelliJ IDEA que mostra o painel de modernização do GitHub Copilot com tarefas de atualização e o painel de chat executando o processo de atualização.

Use as seguintes etapas para iniciar o processo de atualização:

  1. Abra um terminal e navegue até o diretório do projeto Java.

  2. Execute o comando de atualização:

    copilot --model claude-sonnet-4.6 --agent modernize-java:modernize-java

  3. Depois que o agente for iniciado, digite sua solicitação de atualização:

    upgrade to Java 21 + Spring Boot 3.5.x

Captura de tela de um terminal que mostra a CLI do Copilot iniciando uma atualização do Java com o agente modernize-java.

Selecionar destinos de atualização

Depois de iniciar a atualização, o agente solicitará que você selecione suas versões de destino. Escolha a versão de Java desejada e, se aplicável, a versão do Spring Boot para seu projeto.

Captura de tela do Visual Studio Code que mostra a solicitação de seleção da versão de destino do Java com opções para Java 21, 17 e 25.

Examinar e editar o plano de atualização

GitHub Copilot analisa a modernização do projeto Java no workspace atual, incluindo seu JDK, ferramentas de construção e dependências. A ferramenta gera um arquivo plan.md que inclui:

  • Ferramentas Disponíveis – JDKs detectados e ferramentas de build em seu ambiente.
  • Diretrizes – restrições especificadas pelo usuário para o processo de atualização.
  • Opções : configuração de branch de trabalho e teste.
  • Metas de Atualização – versões de origem e destino para cada componente.
  • Pilha de tecnologia – análise de compatibilidade de dependência com motivos de incompatibilidade.
  • Atualizações derivadas — atualizações adicionais exigidas pelos destinos primários (por exemplo, javax → migração de namespace jakarta ao atualizar para o Spring Boot 3.x).
  • Análise de Impacto – detalhamento das alterações de dependência, alterações no código-fonte, alterações de configuração, alterações de CI/CD e riscos.
  • Etapas de atualização – etapas de migração ordenadas com critérios de racionalidade e verificação.

Examine o plano e faça alterações, se necessário, e confirme a continuação. Para obter informações sobre personalização adicional, consulte Personalizar o plano de atualização.

Dica

Verifique se o plano corresponde aos destinos de atualização desejados– por exemplo, Java 8 a Java 21, Spring Boot 1.5 a 3.5.

Captura de tela do Visual Studio Code mostrando o arquivo plan.md com objetivos de atualização e pilha tecnológica.

Executar a atualização

Depois de confirmar o plano, o agente continua automaticamente com a fase de transformação de código. Como parte desse processo, ele executa as seguintes tarefas:

  • Modifica arquivos de código e configuração para garantir a compatibilidade com as versões de destino.
  • Executa a validação de build para confirmar se o projeto é compilado com êxito em cada etapa.
  • Executa a validação de teste se habilitada nas opções de plano.

O agente itera em cada etapa de atualização até que todas as etapas sejam concluídas com êxito. Você pode monitorar o progresso a qualquer momento verificando o arquivo progress.md no editor.

Screenshot de Visual Studio Code que mostra o arquivo progress.md com status da etapa de atualização.

Validação e correção de CVE

Após a conclusão das etapas de transformação de código, o agente verifica automaticamente as dependências para problemas comuns de vulnerabilidades e exposições (CVE). Se forem identificadas CVEs, o agente as corrige por meio da atualização das dependências afetadas — nenhuma intervenção manual é necessária. Em seguida, a etapa de validação final é executada para confirmar se tudo ainda é compilado e aprovado em testes após as correções de CVE.

Exibir o resumo

Após a atualização, a ferramenta gera um arquivo summary.md , que inclui:

  • Resumo Executivo – uma visão geral de um parágrafo do que foi atualizado e do resultado.
  • Aprimoramentos de atualização — uma tabela de comparação antes/depois com os principais benefícios.
  • Compilação e validação – status do build e resultados do teste.
  • Limitações – quaisquer problemas não afixáveis restantes após a atualização.
  • Próximas etapas recomendadas – ações de acompanhamento sugeridas, como gerar testes de unidade ou abordar quaisquer CVEs não corrigidos restantes.
  • Detalhes adicionais : metadados do projeto, alterações de código e resultados de verificação CVE.

Screenshot de Visual Studio Code que mostra o conteúdo resumo da atualização.

Captura de tela do IntelliJ IDEA que mostra o resumo da atualização com o Resultado da atualização do Java e o painel de chat mostrando que a atualização foi concluída.

Captura de tela de um terminal que mostra o resumo da atualização com alterações nos arquivos após concluir a atualização do Java 11 para 21 e do Spring Boot 2.7 para 3.5.

Próxima etapa

Início rápido: gerar testes de unidade com a modernização do GitHub Copilot

  • Last updated on