Início Rápido: atualizar um projeto Java com a Modernização do Aplicativo Copilot do GitHub – atualização para Java (versão prévia)

2025-05-29

Este guia de início rápido mostra como atualizar um projeto Java usando a Modernização do Aplicativo Copilot do GitHub – atualização para Java (versão prévia).

Pré-requisitos

Uma conta do GitHub com o GitHub Copilot habilitado, usando o plano Business ou Enterprise.
A versão mais recente do Visual Studio Code.
A versão mais recente da extensão do GitHub Copilot no Visual Studio Code.
Pacote de extensão do GitHub Copilot para Modernização de Aplicativos. Para obter instruções de instalação, consulte a próxima seção.

Esse pacote de extensão agrupa as duas extensões a seguir:
- Modernização do aplicativo Copilot do GitHub para Java (versão prévia)
- Modernização do aplicativo Copilot do GitHub – atualização para Java (versão prévia)
A Modernização de Aplicativos não requer Java em seu ambiente local. No entanto, para criar seu projeto com êxito, instale a versão correta do Java e do Maven. Recomendamos o Microsoft Build do OpenJDK e do Maven.
As versões instaladas dos JDKs de origem e de destino.
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.
Verifique se "chat.extensionTools.enabled" está definido como true nas configurações do Visual Studio Code. 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+ terá suporte. Não há suporte para a DSL do Kotlin.

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:

No Visual Studio Code, abra a visualização Extensões na Barra de Atividades.
Pesquise por Modernização do Aplicativo Copilot do GitHub no mercado.
Selecione o pacote de extensão GitHub Copilot para Modernização de Aplicativos.
Na página de extensão, selecione Instalar.
Reinicie o Visual Studio Code.

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: mensagens uportal
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:

Abra o projeto Java selecionado no Visual Studio Code.
Abra o painel de Chat do GitHub Copilot.
Alterne para o Modo do Agente.
Insira um prompt, como Atualizar projeto para Java 21 e Spring Boot 3.2.
Quando solicitado, selecione Continuar a gerar um plano de atualização.

Examinar e editar o plano de atualização

A Modernização de Aplicativos – atualização para Java em versão prévia analisa o projeto Java no espaço de trabalho 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 de framework e biblioteca.

Revise o plano e faça alterações, se necessário, e selecione Continuar para prosseguir.

Dica

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 compilado com êxito.

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 Agente do Copilot do GitHub 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 voltará para tratá-los.