Início Rápido: atualizar um projeto Java com a modernização do aplicativo GitHub Copilot

As atualizações java de modernização de aplicativos dão suporte aos seguintes cenários:

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

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

Prerequisites

• 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.
    • GitHub Copilot no Visual Studio Code. Para obter instruções de instalação, consulte Configurar o GitHub Copilot 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 versão mais recente do IntelliJ IDEA. Deve ser a versão 2023.3 ou posterior.
    • GitHub Copilot. Deve ser a versão 1.5.59 ou posterior. Para obter mais instruções, consulte Configurar o GitHub Copilot no IntelliJ IDEA. Certifique-se de entrar em 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 diretamente a modernização do aplicativo GitHub Copilot.
    • Para uso mais eficiente do Copilot na modernização de aplicativos: nas configurações do IntelliJ IDEA, abra a janela de configuração em Ferramentas>GitHub Copilot, e então selecione Aprovar automaticamente e Confiar nas Anotações da Ferramenta MCP. 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 de origem e destino do JDK.
• Maven ou Gradle para criar projetos Java.
• Um projeto Java gerenciado pelo Git usando o Maven ou o Gradle.
• Para projetos baseados em Maven: acesso ao repositório público do Maven Central.
• Nas configurações do Visual Studio Code, certifique-se de que chat.extensionTools.enabled está definido como true. Essa configuração pode ser controlada pela sua organização.

Note

Se você estiver usando o Gradle, somente o wrapper Gradle versão 5+ terá suporte. Não há suporte para a DSL (Linguagem Específica do Domínio Kotlin).

A função My Tasks ainda não tem suporte para IntelliJ IDEA.

Entre para usar o Copilot e instale a extensão necessária

Para usar o GitHub Copilot, entre em sua conta do GitHub no Visual Studio Code. Selecione o ícone copilot na parte superior do Visual Studio Code para acessar o painel do GitHub Copilot. 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 a visualização Extensões na Barra de Atividades.
2. Pesquise a modernização do aplicativo GitHub Copilot no marketplace.
3. Selecione a modernização do aplicativo GitHub Copilot.
4. Na página de extensão, selecione Instalar.
5. Reinicie o Visual Studio Code.

Tip

Para obter a melhor experiência no IntelliJ, recomendamos definir algumas configurações de chave. 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ê deverá ver uma notificação no canto do Visual Studio Code confirmando o êxito.

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

Selecione um projeto Java para atualizar

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

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

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

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

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

2. Abra o painel de Chat do GitHub Copilot.

3. Alterne para o Modo do Agente.

4. Insira um prompt, como Atualizar projeto para Java 21 usando ferramentas de atualização java ou projeto de atualização para Java 21 e Spring Boot 3.2 usando ferramentas de atualização java para incluir informações da estrutura.

   Note

   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 a gerar um plano de atualização.

Examinar e editar o plano de atualização

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

• Versões do JDK de origem e de destino.
• Caminhos de atualização da estrutura e da biblioteca.

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

Tip

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

Aplicar alterações de código e corrigir problemas de build

Em seguida, o GitHub Copilot continua com a fase de transformação de código do projeto. Ele usa uma ferramenta de software livre 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 de build/correção dinâmico. 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 confirmar a etapa de transformação OpenRewrite, selecione Continuar para atualizar o código Java usando OpenRewrite. Essa etapa pode levar alguns minutos.

Para passar pela etapa de fluxo dinâmico de construção/correção, selecione Continuar para compilar o projeto e corrigir erros.

Copilot repete o processo corrigindo erros até que não haja mais problemas. O progresso é mostrado em um arquivo de progress.md . O loop continua até que o projeto seja construído com sucesso.

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

Em determinadas circunstâncias, a atualização pode causar alterações de comportamento de código ou introduzir bibliotecas com problemas comuns de vulnerabilidades e exposições (CVE). A ferramenta executa uma verificação extra para esses problemas.

Quando o GitHub Copilot solicitar Executar Validação caso alguma dependência modificada tenha CVEs conhecidas, selecione Continuar.

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

Após a verificação da CVE, quando solicitado a executar a validação da consistência do comportamento do código, selecione Continuar.

Se forem encontrados problemas, o Modo de Agente do Copilot 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 recompila o projeto e executa novamente as verificações anteriores.

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

Exibir o resumo

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

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

Próxima etapa

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