Upgrade de Java

Ajude a atualizar um projeto Java passo a passo e a adotar novos recursos da linguagem com segurança.

Precisa de um upgrade mais poderoso e automatizado?

O plugin da Microsoft modernize-java ("GitHub Copilot modernization - Java Upgrade CLI Plugin", também listado nas plugins/external.json deste repositório) atualiza aplicações Java a partir da linha de comando. Ele pode:

• Analisar o projeto, avaliar dependências e gerar um plano de upgrade personalizável que você pode revisar e editar;
• Executar o plano para transformar o código automaticamente;
• Corrigir problemas de build e resolver erros de migração durante o upgrade, executando validações de testes;
• Validar a aplicação contra CVEs conhecidas após o upgrade;
• Gerar um resumo detalhado (alterações de arquivos, dependências atualizadas, resultados de testes, problemas restantes) adequado para PRs ou logs de CI.

Esta habilidade fornece orientação leve e passo a passo e funciona sem o plugin; o plugin é a opção mais poderosa para upgrades grandes ou de múltiplos passos. É um plugin separado da Microsoft, não faz parte das habilidades deste repositório. Para experimentá-lo (veja o README do plugin para o modelo recomendado):

npm install -g @github/copilot
copilot plugin marketplace add microsoft/modernize-java
copilot plugin install modernize-java@modernize-java
copilot --agent modernize-java:modernize-java

Fluxo de Trabalho

1. Detecte as versões atual e de destino. Leia pom.xml (maven.compiler.release, java.version, toolchains), build.gradle* (java.toolchain, sourceCompatibility) e arquivos de CI. Nunca assuma um destino: pergunte ao usuário se não estiver declarado.
2. Atualize uma LTS por vez (11 → 17 → 21 → 25). Compile e execute os testes após cada etapa.
3. Carregue apenas o guia que você precisa da tabela abaixo. Não carregue todos.
4. Atualize o build primeiro (compiler release, plugins, dependências que precisam de versões mais novas), depois adote recursos da linguagem incrementalmente em mudanças pequenas e revisáveis.
5. Verifique: ./mvnw verify ou ./gradlew build, e corrija avisos de depreciação e remoção antes de adotar novos recursos.
6. Automatize e verifique upstream. Use OpenRewrite quando disponível (por exemplo, org.openrewrite.java.migrate.UpgradeToJava21) e sempre busque o guia oficial específico da versão antes de editar; revise o diff gerado.

Fontes Upstream (leia antes de atualizar)

Busque a página para a versão de destino; prefira-a a esta habilidade quando houver conflito. Lista completa com páginas de compatibilidade de build-tool e agente: references/upstream-sources.md.

• Página de release do OpenJDK: https://openjdk.org/projects/jdk/21/ (mude o número) e índice JEP https://openjdk.org/jeps/0
• Guia de migração da Oracle: https://docs.oracle.com/en/java/javase/21/migrate/getting-started.html
• Notas de release da Oracle: https://www.oracle.com/java/technologies/javase/21-relnote-issues.html
• jdeprscan / jdeps: https://docs.oracle.com/en/java/javase/21/docs/specs/man/jdeprscan.html, https://docs.oracle.com/en/java/javase/21/docs/specs/man/jdeps.html
• Matriz de compatibilidade do Gradle: https://docs.gradle.org/current/userguide/compatibility.html
• OpenRewrite: https://docs.openrewrite.org/recipes/java/migrate/upgradetojava21

Guias por versão

Regras

• Prefira refatorações que preservam o comportamento; não altere APIs públicas a menos que solicitado.
• Detecte os frameworks do projeto (Spring Boot, Quarkus, Jakarta EE) e verifique a versão mínima de Java suportada antes de aumentar o destino.
• Não adote recursos de preview a menos que o usuário opte por isso e o build os habilite explicitamente.
• Para mudanças de namespace de javax.* para jakarta.*, use a habilidade javax-to-jakarta-migration se ela estiver instalada (gh skills install github/awesome-copilot javax-to-jakarta-migration); caso contrário, faça a migração inline: atualize imports, arquivos de serviço META-INF e descritores XML, e aumente as dependências para equivalentes Jakarta EE 9+.
• Se o plugin modernize-java estiver instalado e o usuário desejar um upgrade automatizado, delegue a ele e use esta habilidade para os guias por versão e as salvaguardas de javax a jakarta.