Snabbstart: Uppgradera ett Java-projekt med GitHub Copilot-appmodernisering

Den här snabbstarten visar hur du uppgraderar ett Java-projekt med hjälp av GitHub Copilot-appmodernisering.

Prerequisites

• Ett GitHub-konto med GitHub Copilot aktiverat. En Pro-, Pro+-, Business- eller Enterprise-plan krävs.
• En av följande IDE:er:
  • Den senaste versionen av Visual Studio Code. Måste vara version 1.101 eller senare.
    • GitHub Copilot i Visual Studio Code. Installationsinstruktioner finns i Konfigurera GitHub Copilot i Visual Studio Code. Logga in på ditt GitHub-konto i Visual Studio Code.
    • Modernisering av GitHub Copilot-appen. Starta om Visual Studio Code efter installationen.
  • Den senaste versionen av IntelliJ IDEA. Måste vara version 2023.3 eller senare.
    • GitHub Copilot. Måste vara version 1.5.59 eller senare. Mer information finns i Konfigurera GitHub Copilot i IntelliJ IDEA. Logga in på ditt GitHub-konto i IntelliJ IDEA.
    • Modernisering av GitHub Copilot-appen. Starta om IntelliJ IDEA efter installationen. Om du inte har GitHub Copilot installerat kan du installera GitHub Copilot-appmodernisering direkt.
    • För effektivare användning av Copilot i appmodernisering: i IntelliJ IDEA-inställningarna väljer du >GitHub Copilot och väljer sedan Godkänn automatiskt och Lita på MCP-verktygsanteckningar. Mer information finns i Konfigurera inställningar för modernisering av GitHub Copilot-appen för att optimera upplevelsen för IntelliJ.
• 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.
• I Visual Studio Code-inställningarna ska du kontrollera att chat.extensionTools.enabled är inställt på true. Den här inställningen kan styras av din organisation.

Logga in för att använda Copilot och installera sedan det tillägg som krävs

Om du vill använda GitHub Copilot loggar du in på ditt GitHub-konto i Visual Studio Code. Välj Copilot-ikonen överst i Visual Studio Code för att komma åt GitHub Copilot-fönstret. Mer information om hur du konfigurerar GitHub Copilot finns i Konfigurera GitHub Copilot i VS Code.

Använd sedan följande steg för att installera tillägget i Visual Studio Code:

1. I Visual Studio Code öppnar du vyn Tillägg från aktivitetsfältet .
2. Sök efter modernisering av GitHub Copilot-appen på marknadsplatsen.
3. Välj Modernisering av GitHub Copilot-appen.
4. På tilläggssidan väljer du Installera.
5. Starta om Visual Studio Code.

När installationen är klar bör du se ett meddelande i hörnet av Visual Studio Code som bekräftar att den har slutförts.

Mer information finns i Installera ett VS Code-tillägg.

Välj ett Java-projekt att uppgradera

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

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

Starta GitHub Copilot-agentläget och starta uppgraderingen

Använd följande steg för att starta GitHub Copilot-agentläget och starta uppgraderingsprocessen:

1. Öppna det valda Java-projektet i Visual Studio Code.

2. Öppna GitHub Copilot Chat-panelen.

3. Växla till Agentläge.

4. Ange en uppmaning, till exempel Uppgradera projekt till Java 21 med hjälp av Java-uppgraderingsverktyg eller Uppgradera projekt till Java 21 och Spring Boot 3.2 med hjälp av Java-uppgraderingsverktyg för att inkludera ramverksinformation.

   Note

   Om du bara behöver uppgradera ett ramverk eller ett beroende från tredje part kan du läsa Uppgradera ett ramverk eller tredjepartsberoende med hjälp av modernisering av GitHub Copilot-appen.

5. När du uppmanas till det väljer du Fortsätt för att generera en uppgraderingsplan.

Granska och redigera uppgraderingsplanen

Moderniseringen av GitHub Copilot-appen analyserar Java-projektet på den aktuella arbetsytan, inklusive dess JDK, byggverktyg och beroenden. Verktyget genererar en plan.md fil som beskriver följande planerade ändringar:

• Käll- och mål-JDK-versioner.
• Uppgraderingsvägar för ramverk och bibliotek.

Granska planen och gör ändringar om det behövs och välj sedan Fortsätt för att fortsätta. Information om ytterligare anpassning, till exempel att lägga till fler byggverktygsparametrar, finns i Anpassa uppgraderingsplanen.

Tillämpa kodändringar och åtgärda byggproblem

GitHub Copilot fortsätter sedan med projektets kodtransformeringsfas. Det använder ett verktyg med öppen källkod som heter OpenRewrite för att implementera vissa kodändringar baserat på specifika recept. Sedan löser AI de återstående problemen via en dynamisk build/fix-loop. Du kan övervaka förloppet i redigeringsområdet i Visual Studio Code genom att kontrollera progress.md markdown-filen när som helst.

I olika skeden av processen uppmanar GitHub Copilot dig att fortsätta.

För steget Bekräfta OpenRewrite-transformering väljer du Fortsätt för att uppgradera Java-kod med Hjälp av OpenRewrite. Det här steget kan ta några minuter.

I steget Godkänn loopsteget Godkänn dynamisk version/korrigering väljer du Fortsätt för att skapa projektet och åtgärdar fel.

Copilot itererar och fortsätter att åtgärda fel tills det inte finns några fler problem. Förloppet visas i en progress.md fil. Loopen fortsätter tills projektet har skapats.

Sök efter sårbarheter och ändringar av kodbeteende

Under vissa omständigheter kan uppgraderingen orsaka ändringar i kodbeteendet eller introducera bibliotek med problem med vanliga sårbarheter och exponeringar (CVE). Verktyget utför en extra kontroll av dessa problem.

När GitHub Copilot frågar Kör Verifiera om några ändrade beroenden har kända CVE:er väljer du Fortsätt.

Om CVE:er hittas försöker GitHub Copilot-agentläget åtgärda dem. Granska ändringarna i VS Code och bestäm om de ska behållas.

Efter CVE-kontrollen väljer du Fortsätt när du uppmanas att köra validering av kodbeteendets konsekvens.

Om problem hittas försöker GitHub Copilot-agentläget att lösa dem. Bestäm om ändringarna ska behållas eller ignoreras.

När kontrollerna har slutförts återskapar GitHub Copilot projektet och kör de tidigare kontrollerna igen.

Om mindre problem kvarstår som inte kräver omedelbara korrigeringar är uppgraderingen klar. Annars återvänder GitHub Copilot för att åtgärda dem.

Visa sammanfattningen

Efter uppgraderingen genererar verktyget en sammanfattning i summary.md-filen , som innehåller följande information:

• Projektinformation.
• Kodrader har ändrats.
• Uppdaterade beroenden.
• Sammanfattade kodändringar.
• Åtgärdade eventuella problem med CVE-säkerhet och kodinkonsekvens.
• Oadresserade mindre CVE-problem.

Nästa steg

Snabbstart: Generera enhetstester med GitHub Copilot-appmodernisering