Guia de início rápido: atualizar um projeto Java com a modernização do aplicativo GitHub Copilot

Modernização de aplicações As atualizações Java suportam os seguintes cenários:

• Atualize o Java Development Kit (JDK) para Java 8, 11, 17, 21 ou 25.
• Atualize o Spring Boot para a versão 3.5.
• Atualize o Spring Framework até à versão 6.2+.
• Atualize Java EE para Jakarta EE, até Jacarta EE 10.
• Atualizar JUnit.
• Atualize as dependências de terceiros para uma versão especificada.
• Atualizar Ant para uma compilação Maven.

Este guia de início rápido mostra como atualizar um projeto Java usando a modernização do aplicativo GitHub Copilot.

Pré-requisitos

• Uma conta do GitHub com o GitHub Copilot habilitado. É necessário um plano Free Tier, Pro, Pro+, Business ou Enterprise.
• Um dos seguintes IDEs:
  • A versão mais recente do Visual Studio Code. Deve ser a versão 1.101 ou posterior.
    • Copiloto do GitHub no Visual Studio Code. Para obter instruções de configuração, consulte Configurar o Copilot do GitHub no Visual Studio Code. Certifique-se de entrar em sua conta do GitHub no Visual Studio Code.
    • Modernização do aplicativo GitHub Copilot. Reinicie o Visual Studio Code após a instalação.
  • A última versão do IntelliJ IDEA. Deve ser a versão 2023.3 ou posterior.
    • Copiloto do GitHub. Deve ser versão 1.5.59 ou posterior. Para obter mais instruções, consulte Configurar o Copilot do GitHub no IntelliJ IDEA. Certifique-se de fazer login na sua conta do GitHub no IntelliJ IDEA.
    • Modernização do aplicativo GitHub Copilot. Reinicie o IntelliJ IDEA após a instalação. Se você não tiver o GitHub Copilot instalado, poderá instalar a modernização do aplicativo GitHub Copilot diretamente.
    • Para um uso mais eficiente do Copilot na modernização do aplicativo: nas configurações do IntelliJ IDEA, selecione a janela de configuração Tools> e, em seguida, selecione Auto-approve e Trust MCP Tool Annotations. Para obter mais informações, consulte Definir configurações para a modernização do aplicativo GitHub Copilot para otimizar a experiência do IntelliJ.
• Java JDK para as versões JDK de origem e de destino.
• Maven ou Gradle para construir projetos Java.
• Um projeto Java gerenciado pelo Git usando Maven ou Gradle.
• Para projetos baseados em Maven: acesso ao repositório público do Maven Central.
• Nas configurações do Visual Studio Code, verifique se chat.extensionTools.enabled está definido como true. Essa configuração pode ser controlada pela sua organização.

Observação

Se você estiver usando o Gradle, somente o wrapper Gradle versão 5+ é suportado. O Kotlin Domain Specific Language (DSL) não é suportado.

A função My Tasks ainda não é suportada pelo IntelliJ IDEA.

Inicie sessão para utilizar o Copilot e, em seguida, instale a extensão necessária

Para usar o GitHub Copilot, entre na sua conta do GitHub no Visual Studio Code. Selecione o ícone Copilot na parte superior do Visual Studio Code para acessar o painel Copilot do GitHub. Para obter mais informações sobre como configurar o GitHub Copilot, consulte Configurar o GitHub Copilot no VS Code.

Em seguida, use as seguintes etapas para instalar a extensão no Visual Studio Code:

1. No Visual Studio Code, abra o painel Extensões na Barra de Atividades.
2. Procure por modernização do aplicativo GitHub Copilot no marketplace.
3. Selecione Modernização do aplicativo GitHub Copilot.
4. Na página da extensão, selecione Instalar.
5. Reinicie o Visual Studio Code.

Sugestão

Para obter a melhor experiência no IntelliJ, recomendamos a configuração de algumas configurações principais. Para obter mais informações, consulte Definir configurações para a modernização do aplicativo GitHub Copilot para otimizar a experiência do IntelliJ.

Após a conclusão da instalação, você verá uma notificação no canto do Visual Studio Code confirmando o sucesso.

Para obter mais informações, consulte Instalar uma extensão VS Code.

Selecione um projeto Java para atualizar

Para os fins deste tutorial, escolha um dos seguintes repositórios de exemplo:

• Maven: uportal-messaging
• Gradle: docraptor-java

Inicie o Modo de Agente Copiloto do GitHub e inicie a atualização

Use as seguintes etapas para iniciar o Modo de Agente Copiloto do GitHub e iniciar o processo de atualização:

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

2. Abra o painel Chat do Copilot do GitHub.

3. Mude para o Modo de Agente.

4. Insira um prompt como Atualizar projeto para Java 21 usando as ferramentas de atualização Java ou Atualizar projeto para Java 21 e Spring Boot 3.2 usando as ferramentas de atualização Java para incluir informações sobre frameworks.

   Observação

   Se você precisar atualizar apenas uma estrutura ou dependência de terceiros, consulte Atualizar uma estrutura ou dependência de terceiros usando a modernização do aplicativo GitHub Copilot.

5. Quando solicitado, selecione Continuar para gerar um plano de atualização.

Rever e editar o plano de atualização

A modernização do aplicativo GitHub Copilot analisa o projeto Java no espaço de trabalho atual, incluindo seu JDK, ferramentas de compilação e dependências. A ferramenta gera um arquivo plan.md que descreve as seguintes alterações planejadas:

• Versões JDK de origem e de destino.
• Vias de atualização de framework e biblioteca.

Revise o plano e faça alterações, se necessário, e selecione Continuar para continuar. Para obter informações sobre personalização adicional, como adicionar mais parâmetros da ferramenta de compilação, consulte Personalizar o plano de atualização.

Sugestão

Certifique-se de que o plano corresponde aos seus destinos de atualização desejados - por exemplo, Java 8 para Java 21, Spring Boot 2.7 para 3.2.

Aplicar alterações de código e corrigir problemas de compilação

Em seguida, o GitHub Copilot prossegue com a fase de transformação de código do projeto. Ele usa uma ferramenta de código aberto chamada OpenRewrite para implementar algumas alterações de código com base em receitas específicas. Em seguida, a IA aborda os problemas restantes por meio de um loop dinâmico de compilação/correção. Você pode monitorar o progresso na área do editor do Visual Studio Code verificando o arquivo de marcação progress.md a qualquer momento.

Em vários estágios do processo, o GitHub Copilot solicita que você continue.

Para a etapa Confirmar a transformação OpenRewrite , selecione Continuar para atualizar o código Java usando OpenRewrite. Esta etapa pode levar alguns minutos.

Para a etapa Aprovar o loop dinâmico de compilação/correção , selecione Continuar para criar o projeto e corrigir erros.

O copiloto itera e continua a corrigir erros até que não haja mais problemas. O progresso é mostrado em um arquivo progress.md . O loop continua até que o projeto seja compilado com êxito.

Verificar vulnerabilidades e alterações de comportamento de código

Em determinadas circunstâncias, a atualização pode causar alterações no comportamento do código ou introduzir bibliotecas com problemas de CVE (Common Vulnerabilities and Exposures). A ferramenta realiza uma verificação extra para esses problemas.

Quando o GitHub Copilot solicitar Executar Validar se alguma dependência modificada tiver CVEs conhecidas, selecione Continuar.

Se forem encontrados CVEs, o Modo Agente do GitHub Copilot tentará corrigi-los. Analise as alterações no VS Code e decida se deseja mantê-las.

Após a verificação CVE, quando solicitado a Executar Validar consistência de comportamento de código, selecione Continuar.

Se forem encontrados problemas, o Modo de Agente Copiloto do GitHub tentará resolvê-los. Decida se deseja manter ou descartar as alterações.

Após a conclusão das verificações, o GitHub Copilot reconstrói o projeto e executa novamente as verificações anteriores.

Se permanecerem pequenos problemas que não exijam correções imediatas, a atualização será concluída. Caso contrário, o GitHub Copilot volta para abordá-los.

Ver o resumo

Após a atualização, a ferramenta gera um resumo no arquivo summary.md , que inclui as seguintes informações:

• Informação do projeto.
• Linhas de código alteradas.
• Dependências atualizadas.
• Alterações de código resumidas.
• Corrigidos problemas de segurança CVE e inconsistência de código, se houver.
• Problemas menores de CVE não resolvidos.

Próximo passo

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