Snabbstart: Uppgradera ett Java projekt med GitHub Copilot modernisering

Modernisering med GitHub Copilot ger en AI-stödd agentbaserad upplevelse som automatiserar arbetsflöden för Java-uppgradering från början till slut – från projektanalys och generering av planer till kodomvandling, byggverifiering och åtgärd av CVE:er.

Uppgraderingsscenarier som stöds

  • Uppgradera Java Development Kit (JDK) till Java 11, 17, 21 eller 25.
  • Uppgradera Spring Boot till version 4.0.
  • Uppgradera Spring Framework till version 7.x.
  • Uppgradera Java EE till Jakarta EE, upp till Jakarta EE 11.
  • Uppgradera Azure SDKs för Java.
  • Uppgradera JUnit.
  • Uppgradera beroenden från tredje part till en angiven version.

Förutsättningar

  • Ett GitHub konto med GitHub Copilot aktiverat. Du behöver en kostnadsfri nivå, Pro, Pro+, Business eller Enterprise-plan.
  • Java JDK för både käll- och mål-JDK-versioner.
  • Maven eller Gradle för att skapa Java projekt.
  • Ett Git-hanterat Java projekt med Maven eller Gradle.
  • För Maven-baserade projekt: åtkomst till den offentliga Maven Central-lagringsplatsen.

  • Installera GitHub Copilot CLI-verktyget:

    npm install -g @github/copilot

  • Installera GitHub Copilot-pluginen för modernisering:

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

Anmärkning

Ett Azure-konto krävs endast för att distribuera resurser till Azure och behövs inte när du använder GitHub Copilot modernisering för att göra kodändringar.

Om du använder Gradle stöds endast Gradle-omslutningsversionen 5 eller senare.

Kotlin Domain Specific Language (DSL) stöds inte.

Välj ett Java projekt som ska uppgraderas

I den här självstudien väljer du någon av följande exempellagringsplatser:

Starta uppgraderingen

Använd följande steg för att starta uppgraderingsprocessen:

  1. Öppna det markerade Java projektet i Visual Studio Code.

  2. I sidofältet öppnar du panelen GitHub Copilot modernisering för att se sidan Snabbstart.

  3. Välj Uppgradera Java Runtime och ramverk.

    Den här åtgärden öppnar GitHub Copilot Chat i agentläge och startar uppgraderingsprocessen automatiskt.

    Tips/Råd

    Du kan också välja en specifik uppgift från aktivitetsträdet under snabbstartspanelen (till exempel Uppgradera Spring Boot-version eller Uppgradera Jakarta EE-version) för att utlösa en riktad uppgradering.

    Du kan också skriva direkt i GitHub-Copilot Chat med hjälp av agentläge – till exempel "Uppgradera mitt Java-projekt till Java 21 – för att starta uppgraderingen.

Skärmbild av Visual Studio Code som visar QuickStart-sidan med knappen Uppgradera Java Runtime och ramverk.

Använd följande steg för att starta uppgraderingsprocessen:

  1. Öppna det markerade Java projektet i IntelliJ IDEA.

  2. I sidofältet öppnar du panelen GitHub Copilot modernisering för att se sidan Snabbstart.

  3. Välj Uppgradera körnings- och ramverk.

    Den här åtgärden öppnar GitHub Copilot Chat i agentläge och startar uppgraderingsprocessen automatiskt.

    Tips/Råd

    Du kan också skriva direkt i GitHub Copilot Chat med hjälp av agentläge , till exempel "Uppgradera mitt Java projekt till Java 21" - för att starta uppgraderingen.

Skärmbild av IntelliJ IDEA som visar GitHub Copilot moderniseringspanelen med uppgraderingsuppgifter och chattpanelen som kör uppgraderingsprocessen.

Använd följande steg för att starta uppgraderingsprocessen:

  1. Öppna en terminal och gå till din Java projektkatalog.

  2. Kör uppgraderingskommandot:

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

  3. När agenten har startat skriver du din uppgraderingsbegäran:

    upgrade to Java 21 + Spring Boot 3.5.x

Skärmbild av en terminal som visar att Copilot CLI startar en Java-uppgradering med agenten modernize-java.

Välj uppgraderingsmål

När du har påbörjat uppgraderingen uppmanar agenten dig att välja dina målversioner. Välj önskad Java version och, om tillämpligt, Spring Boot-versionen för projektet.

Skärmbild av Visual Studio Code som visar meddelandet om val av målversion Java version med alternativ för Java 21, 17 och 25.

Granska och redigera uppgraderingsplanen

GitHub Copilot modernisering analyserar Java projektet på den aktuella arbetsytan, inklusive dess JDK, byggverktyg och beroenden. Verktyget genererar en plan.md fil som innehåller:

  • Tillgängliga verktyg – identifierade JDK:er och byggverktyg i din miljö.
  • Riktlinjer – användardefinierade begränsningar för uppgraderingsprocessen.
  • Alternativ – arbetsgren och testkonfiguration.
  • Uppgraderingsmål – käll- och målversioner för varje komponent.
  • Technology Stack – beroendekompatibilitetsanalys med inkompatibilitetsskäl.
  • Härledda uppgraderingar – ytterligare uppgraderingar som krävs av de primära målen (till exempel javax → jakarta-namnområdesmigrering vid uppgradering till Spring Boot 3.x).
  • Konsekvensanalys – detaljerad uppdelning av beroendeändringar, källkodsändringar, konfigurationsändringar, CI/CD-ändringar och risker.
  • Uppgraderingssteg – ordnade migreringssteg med motiverings- och verifieringskriterier.

Granska planen och gör ändringar om det behövs och bekräfta sedan att du vill fortsätta. Mer information om ytterligare anpassning finns i Anpassa uppgraderingsplanen.

Tips/Råd

Se till att planen matchar dina önskade uppgraderingsmål – till exempel Java 8 till Java 21, Spring Boot 1.5 till 3.5.

Skärmbild av Visual Studio Code som visar plan.md-filen med uppgraderingsmål och teknik stack.

Kör uppgraderingen

När du har bekräftat planen fortsätter agenten automatiskt med kodtransformeringsfasen. Som en del av den här processen utför den följande uppgifter:

  • Ändrar kod- och konfigurationsfiler för att säkerställa kompatibilitet med målversionerna.
  • Utför byggverifiering för att bekräfta att projektet kompileras korrekt i varje steg.
  • Kör testverifiering om det är aktiverat i planalternativen.

Agenten itererar genom varje uppgraderingssteg tills alla steg har slutförts. Du kan övervaka förloppet när som helst genom att kontrollera progress.md filen i redigeraren.

Skärmbild av Visual Studio Code som visar progress.md-filen med uppgraderingsstegstatus.

CVE-validering och korrigering

När kodtransformeringsstegen har slutförts genomsöker agenten automatiskt beroenden efter vanliga problem med sårbarheter och exponeringar (CVE). Om CVE:er hittas korrigerar agenten dem genom att uppgradera de berörda beroendena – ingen manuell åtgärd krävs. Det sista valideringssteget körs sedan för att bekräfta att allt fortfarande kan byggas och klarar testerna efter CVE-korrigeringarna.

Visa sammanfattningen

Efter uppgraderingen genererar verktyget en summary.md fil, som innehåller:

  • Sammanfattning – en översikt över vad som har uppgraderats och resultatet.
  • Uppgraderingsförbättringar – en före/efter jämförelsetabell med viktiga fördelar.
  • Bygg och validering – byggstatus och testresultat.
  • Begränsningar – eventuella problem som inte kan åtgärdas efter uppgraderingen.
  • Rekommenderade nästa steg – föreslagna uppföljningsåtgärder som att generera enhetstester eller åtgärda eventuella återstående ofixerade CVE:er.
  • Ytterligare information – projektmetadata, kodändringar och CVE-genomsökningsresultat.

Skärmbild av Visual Studio Code som visar uppgraderingens sammanfattningsinnehåll.

Skärmbild av IntelliJ IDEA som visar uppgraderingssammanfattningen med Java Uppgraderingsresultat och chattpanelen som visar uppgraderingens slutförande.

Skärmbild av en terminal som visar uppgraderingssammanfattningen med filändringar efter att ha slutfört en Java 11 till 21 och Spring Boot 2.7 till 3.5 upgrade.

Nästa steg

Quickstart: generera enhetstester med modernisering av GitHub Copilot

  • Last updated on