Guia Rápido: atualizar um projeto Java com a modernização do GitHub Copilot

GitHub Copilot atualizações de modernização do Java oferecem suporte aos seguintes cenários:

• Atualize Java Kit de Desenvolvimento (JDK) para Java 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 Java EE para Jakarta EE, até 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 início rápido mostra como atualizar um projeto Java através da modernização com o GitHub Copilot.

Pré-requisitos

• Uma conta GitHub com 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 em Visual Studio Code. Para obter instruções de configuração, consulte Configurar o GitHub Copilot no Visual Studio Code. Certifique-se de entrar em sua conta GitHub dentro de Visual Studio Code.
    • Modernização do GitHub Copilot. Reinicie 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 Set up GitHub Copilot in IntelliJ IDEA. Certifique-se de entrar em sua conta GitHub no IntelliJ IDEA.
    • GitHub Copilot atualização. Reinicie o IntelliJ IDEA após a instalação. Se você não tiver GitHub Copilot instalado, poderá instalar GitHub Copilot modernização diretamente.
    • Para um uso mais eficiente da modernização do GitHub Copilot: nas configurações do IntelliJ IDEA, selecione a janela de configuração Tools>GitHub Copilot, e então selecione Auto-approve e Trust MCP Tool Annotations. Para obter mais informações, consulte Configurar as configurações de modernização do GitHub Copilot para otimizar a experiência no IntelliJ.
• 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.
• Nas configurações de Visual Studio Code, verifique se chat.extensionTools.enabled está definido como true. Essa configuração pode ser controlada pela sua organização.

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

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

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

1. Em Visual Studio Code, abra a exibição Extensions na Barra de Atividades.
2. Pesquise GitHub Copilot atualização no marketplace.
3. Selecione modernização do GitHub Copilot.
4. Na página de extensão, selecione Instalar.
5. Reinicie Visual Studio Code.

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

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

Selecione um projeto de Java para atualizar

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

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

Inicie o Modo Agente do GitHub Copilot e comece a atualização

Siga as seguintes etapas para iniciar o Modo do Agente do GitHub Copilot e começar a atualização:

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

2. Abra o painel Copilot Chat do GitHub.

3. Alterne para o Modo do Agente.

4. Insira um prompt como Atualize o projeto para Java 21 usando ferramentas de atualização do Java ou Atualize o projeto para Java 21 e Spring Boot 3.2 usando ferramentas de atualização do Java para incluir informações do framework.

   Observação

   Se você precisar atualizar apenas uma estrutura ou dependência de terceiros, consulte atualize uma estrutura ou dependência de terceiros para modernização com o GitHub Copilot.

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

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 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.

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

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 de Visual Studio Code verificando o arquivo de marcação progress.md a qualquer momento.

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

Para a etapa Confirme a transformação OpenRewrite, selecione Continue para atualizar Java código 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 faz iterações e continua 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 Validar se alguma dependência modificada tiver CVEs conhecidos, selecione Continuar.

Se os CVEs forem encontrados, o GitHub Copilot Modo Agente 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 Agente do GitHub Copilot tentará resolvê-los. Decida se deseja manter ou descartar as alterações.

Após a conclusão das verificações, 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 voltará 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 GitHub Copilot