Quickstart: Een Java-project upgraden met GitHub Copilot modernisering

GitHub Copilot voor modernisering biedt een AI-gestuurde, agentgestuurde ervaring die Java-upgradeworkflows end-to-end automatiseert: van projectanalyse en het genereren van een plan tot codetransformatie, buildvalidatie en CVE-herstel.

Ondersteunde upgradescenario's

• Upgrade Java Development Kit (JDK) naar Java 11, 17, 21 of 25.
• Upgrade Spring Boot tot versie 4.0.
• Spring Framework upgraden naar versie 7.x.
• Upgrade Java EE naar Jakarta EE, tot Jakarta EE 11.
• Voer een upgrade uit voor Azure SDK voor Java.
• Werk JUnit bij.
• Werk afhankelijkheden van derden bij naar een specifieke versie.

Vereiste voorwaarden

• Een GitHub-account waarvoor GitHub Copilot is ingeschakeld. U hebt een Gratis Tier, Pro, Pro+, Business of Enterprise abonnement nodig.
• Java JDK voor zowel de bron- als doelversie van JDK.
• Maven of Gradle om Java projecten te bouwen.
• Een door Git beheerd Java project met behulp van Maven of Gradle.
• Voor op Maven gebaseerde projecten: toegang tot de openbare Maven Central-opslagplaats.

• De nieuwste versie van Visual Studio Code.
• GitHub Copilot in Visual Studio Code. Zie Set up GitHub Copilot in Visual Studio Code voor installatie-instructies. Meld u aan bij uw GitHub-account binnen Visual Studio Code.
• GitHub Copilot modernisering. Start Visual Studio Code opnieuw op na de installatie.

• De nieuwste versie van IntelliJ IDEA.
• GitHub Copilot. Zie Set up GitHub Copilot in IntelliJ IDEA voor meer instructies. Meld u aan bij uw GitHub-account in IntelliJ IDEA.
• GitHub Copilot modernisering. Start IntelliJ IDEA opnieuw op na de installatie. Als u GitHub Copilot niet hebt geïnstalleerd, kunt u GitHub Copilot modernisering rechtstreeks installeren.
• Voor efficiënter gebruik van GitHub Copilot modernisering: in de IntelliJ IDEA-instellingen, selecteer het configuratievenster Tools>GitHub Copilot en selecteer vervolgens Auto-approve en Trust MCP Tool Annotaations. Zie Configureer instellingen voor de modernisering van GitHub Copilot om de ervaring voor IntelliJ te optimaliseren voor meer informatie.

• Installeer de GitHub Copilot CLI:

  npm install -g @github/copilot
  

• Installeer de GitHub Copilot moderniseringsinvoegtoepassing:

  copilot plugin marketplace add microsoft/modernize-java
  copilot plugin install modernize-java@modernize-java
  

Opmerking

Een Azure-account is alleen vereist voor het implementeren van resources in Azure en is niet nodig wanneer u GitHub Copilot modernisering gebruikt om codewijzigingen aan te brengen.

Als u Gradle gebruikt, wordt alleen de Gradle-wrapper versie 5 of hoger ondersteund.

De Kotlin Domain Specific Language (DSL) wordt niet ondersteund.

Selecteer een Java-project om een upgrade uit te voeren

Kies voor deze zelfstudie een van de volgende voorbeeldopslagplaatsen:

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

De upgrade starten

Gebruik de volgende stappen om het upgradeproces te starten:

1. Open het geselecteerde Java project in Visual Studio Code.

2. Open in de zijbalk het deelvenster GitHub Copilot modernization om de QuickStart-pagina te bekijken.

3. Selecteer Upgrade Java Runtime & Frameworks.

   Met deze actie wordt GitHub Copilot Chat geopend in de agentmodus en wordt het upgradeproces automatisch gestart.

   Aanbeveling

   U kunt ook een specifieke taak selecteren in de takenstructuur onder het deelvenster QuickStart (bijvoorbeeld Spring Boot-versie upgraden of Jakarta EE-versie upgraden) om een doelupgrade te activeren.

   U kunt ook rechtstreeks in GitHub Copilot Chat typen met behulp van de agentmodus, bijvoorbeeld 'Mijn Java-project upgraden naar Java 21'- om de upgrade te starten.

Gebruik de volgende stappen om het upgradeproces te starten:

1. Open het geselecteerde Java project in IntelliJ IDEA.

2. Open in de zijbalk het deelvenster GitHub Copilot-modernisering om de QuickStart-pagina te bekijken.

3. Selecteer Upgrade Runtime & Frameworks.

   Met deze actie wordt GitHub Copilot Chat geopend in de agentmodus en wordt het upgradeproces automatisch gestart.

   Aanbeveling

   U kunt ook rechtstreeks in GitHub Copilot Chat typen met behulp van de agentmodus, bijvoorbeeld "Upgrade mijn Java project naar Java 21" - om de upgrade te starten.

Gebruik de volgende stappen om het upgradeproces te starten:

1. Open een terminal en navigeer naar uw Java projectmap.

2. Voer de upgradeopdracht uit:

   copilot --model claude-sonnet-4.6 --agent modernize-java:modernize-java
   

3. Nadat de agent is gestart, typt u uw upgradeaanvraag:

   upgrade to Java 21 + Spring Boot 3.5.x
   

Doelen voor upgrade selecteren

Nadat u de upgrade hebt gestart, wordt u door de agent gevraagd uw doelversies te selecteren. Kies de gewenste Java versie en, indien van toepassing, de Spring Boot-versie voor uw project.

Het upgradeplan controleren en bewerken

GitHub Copilot zorgt voor de modernisering door het Java-project in de huidige werkruimte te analyseren, inclusief de JDK, build-tools en afhankelijkheden. Het hulpprogramma genereert een plan.md-bestand met:

• Beschikbare hulpprogramma's — in uw omgeving gedetecteerde JDK’s en buildhulpprogramma’s.
• Richtlijnen : door de gebruiker opgegeven beperkingen voor het upgradeproces.
• Opties : werkbranch en testconfiguratie.
• Upgradedoelen : bron- en doelversies voor elk onderdeel.
• Technologiestack : compatibiliteitsanalyse van afhankelijkheden met incompatibiliteitsredenen.
• Afgeleide upgrades : aanvullende upgrades die zijn vereist voor de primaire doelen (bijvoorbeeld javax → jakarta-naamruimtemigratie bij een upgrade naar Spring Boot 3.x).
• ImpactAnalyse : gedetailleerde uitsplitsing van afhankelijkheidswijzigingen, broncodewijzigingen, configuratiewijzigingen, CI/CD-wijzigingen en risico's.
• Upgradestappen : geordende migratiestappen met rationale- en verificatiecriteria.

Controleer het plan en breng indien nodig wijzigingen aan en bevestig vervolgens om door te gaan. Zie Het upgradeplan aanpassen voor meer informatie over verdere aanpassing.

Aanbeveling

Zorg ervoor dat het plan overeenkomt met de gewenste upgradedoelen, bijvoorbeeld Java 8 tot Java 21, Spring Boot 1.5 tot en met 3.5.

De upgrade uitvoeren

Nadat u het plan hebt bevestigd, gaat de agent automatisch verder met de fase van de codetransformatie. Als onderdeel van dit proces worden de volgende taken uitgevoerd:

• Wijzigt code- en configuratiebestanden om compatibiliteit met de doelversies te garanderen.
• Voert buildvalidatie uit om te bevestigen dat het project bij elke stap met succes wordt gecompileerd.
• Testvalidatie wordt uitgevoerd als deze is ingeschakeld in de planopties.

De agent doorloopt elke upgradestap totdat alle stappen zijn voltooid. U kunt de voortgang op elk gewenst moment controleren door het bestand progress.md in de editor te controleren.

CVE-validatie en oplossing

Nadat de stappen voor codetransformatie zijn voltooid, scant de agent automatisch afhankelijkheden op problemen met Common Vulnerabilities and Exposures (CVE). Als CVE's worden gevonden, worden deze door de agent opgelost door de betrokken afhankelijkheden te upgraden. Er is geen handmatige interventie vereist. De laatste validatiestap wordt vervolgens uitgevoerd om te bevestigen dat alles nog steeds wordt gebouwd en tests doorstaan na de CVE-fixes.

Bekijk het overzicht

Na de upgrade genereert het hulpprogramma een summary.md-bestand , waaronder:

• Managementsamenvatting — een overzicht in één alinea van wat is bijgewerkt en het resultaat.
• Upgradeverbeteringen : een vóór/na vergelijkingstabel met belangrijke voordelen.
• Build en validatie : buildstatus en testresultaten.
• Beperkingen : eventuele problemen die nog niet kunnen worden opgelost na de upgrade.
• Aanbevolen volgende stappen : voorgestelde vervolgacties, zoals het genereren van eenheidstests of het aanpakken van eventuele resterende niet-opgeloste CV's.
• Aanvullende details : projectmetagegevens, codewijzigingen en CVE-scanresultaten.

Volgende stap

Quickstart: unittests genereren met de modernisering door GitHub Copilot