Quickstart: Een Java-project upgraden met de modernisering van GitHub Copilot-apps

In deze quickstart ziet u hoe u een Java-project kunt upgraden met behulp van GitHub Copilot app-modernisering.

Prerequisites

• Een GitHub-account waarvoor GitHub Copilot is ingeschakeld. Een Pro-, Pro+-, Business- of Enterprise-abonnement is vereist.
• Een van de volgende IDE's:
  • De nieuwste versie van Visual Studio Code. Moet versie 1.101 of hoger zijn.
    • GitHub Copilot in Visual Studio Code. Zie GitHub Copilot instellen in Visual Studio Code voor installatie-instructies. Meld u aan bij uw GitHub-account in Visual Studio Code.
    • Modernisering van GitHub Copilot-apps. Start Visual Studio Code opnieuw op na de installatie.
  • De nieuwste versie van IntelliJ IDEA. Moet versie 2023.3 of hoger zijn.
    • GitHub Copilot. Moet versie 1.5.59 of hoger zijn. Zie GitHub Copilot instellen in IntelliJ IDEA voor meer instructies. Meld u aan bij uw GitHub-account in IntelliJ IDEA.
    • Modernisering van GitHub Copilot-apps. Start IntelliJ IDEA opnieuw op na de installatie. Als u GitHub Copilot niet hebt geïnstalleerd, kunt u de modernisering van gitHub Copilot-apps rechtstreeks installeren.
    • Voor efficiënter gebruik van Copilot bij het moderniseren van apps: selecteer in de IntelliJ IDEA-instellingen het configuratievenster Tools>GitHub Copilot en selecteer vervolgens Auto-approve en Trust MCP Tool Annotaations. Zie Instellingen configureren voor de modernisering van GitHub Copilot-apps om de ervaring voor IntelliJ te optimaliseren voor meer informatie.
• Java JDK voor zowel de bron- als de doelversie van JDK.
• Maven of Gradle voor het bouwen van Java-projecten.
• Een Door Git beheerd Java-project met Maven of Gradle.
• Voor op Maven gebaseerde projecten: toegang tot de openbare Maven Central-opslagplaats.
• Zorg ervoor dat chat.extensionTools.enabled in de Visual Studio Code-instellingen is ingesteld op true. Deze instelling kan worden beheerd door uw organisatie.

Meld u aan om Copilot te gebruiken en installeer vervolgens de vereiste extensie

Als u GitHub Copilot wilt gebruiken, meldt u zich aan bij uw GitHub-account in Visual Studio Code. Selecteer het Copilot-pictogram bovenaan Visual Studio Code om toegang te krijgen tot het GitHub Copilot-deelvenster. Zie GitHub Copilot instellen in VS Code voor meer informatie over het instellen van GitHub Copilot.

Gebruik vervolgens de volgende stappen om de extensie te installeren in Visual Studio Code:

1. Open in Visual Studio Code de weergave Extensies op de activiteitenbalk.
2. Zoek naar modernisering van GitHub Copilot-apps in de marketplace.
3. Selecteer modernisering van GitHub Copilot-apps.
4. Selecteer Installeren op de extensiepagina.
5. Start Visual Studio Code opnieuw.

Nadat de installatie is voltooid, ziet u een melding in de hoek van Visual Studio Code om te bevestigen dat de installatie is voltooid.

Zie Een VS Code-extensie installeren voor meer informatie.

Een Java-project selecteren om een upgrade uit te voeren

Voor deze zelfstudie kiest u een van de volgende voorbeeldopslagplaatsen:

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

Start de agentmodus van GitHub Copilot en begin met de upgrade

Gebruik de volgende stappen om de GitHub Copilot-agentmodus te starten en het upgradeproces te starten:

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

2. Open het Copilot-chatvenster van GitHub.

3. Schakel over naar de agentmodus.

4. Voer een prompt in, zoals Een upgradeproject uitvoeren naar Java 21 met behulp van Java-upgradehulpprogramma's of Een project upgraden naar Java 21 en Spring Boot 3.2 met behulp van Java-upgradehulpprogramma's om frameworkinformatie op te nemen.

   Note

   Als u alleen een framework of een afhankelijkheid van derden moet upgraden, raadpleegt u Een framework of afhankelijkheid van derden upgraden met behulp van de modernisering van gitHub Copilot-apps.

5. Wanneer u hierom wordt gevraagd, selecteert u Doorgaan om een upgradeplan te genereren.

Het upgradeplan controleren en bewerken

De modernisering van de GitHub Copilot-app analyseert het Java-project in de huidige werkruimte, met inbegrip van de JDK, buildhulpprogramma's en afhankelijkheden. Het hulpprogramma genereert een plan.md-bestand met een overzicht van de volgende geplande wijzigingen:

• Bron- en doel-JDK-versies.
• Framework- en bibliotheekupgradepaden.

Controleer het plan en breng zo nodig wijzigingen aan en selecteer Doorgaan om door te gaan. Zie Het upgradeplan aanpassen voor meer aanpassingen, zoals het toevoegen van meer parameters voor buildhulpprogramma's.

Codewijzigingen toepassen en buildproblemen oplossen

GitHub Copilot gaat vervolgens verder met de codetransformatiefase van het project. Het maakt gebruik van een opensource-hulpprogramma met de naam OpenRewrite om enkele codewijzigingen te implementeren op basis van specifieke recepten. Vervolgens lost AI de resterende problemen op via een dynamische build/fix-lus. U kunt de voortgang in het editorgebied van Visual Studio Code controleren door het markdown-bestand van progress.md op elk gewenst moment te controleren.

In verschillende fasen van het proces vraagt GitHub Copilot u om door te gaan.

Voor de stap Bevestig de OpenRewrite-transformatie selecteert u Doorgaan om Java-code bij te werken met OpenRewrite. Deze stap kan enkele minuten duren.

Voor de stap Dynamische build/fix-lus goedkeuren selecteert u Doorgaan om het project te bouwen en fouten op te lossen.

Copilot herhaalt en blijft fouten oplossen totdat er geen problemen meer zijn. De voortgang wordt weergegeven in een progress.md-bestand . De lus gaat door totdat het project succesvol gebouwd is.

Controleren op beveiligingsproblemen en wijzigingen in codegedrag

Onder bepaalde omstandigheden kan de upgrade codegedragswijzigingen veroorzaken of bibliotheken introduceren met CVE-problemen (Common Vulnerabilities and Exposures). Het hulpprogramma voert een extra controle uit op deze problemen.

Wanneer GitHub Copilot vraagt om Valideren uit te voeren als er gewijzigde afhankelijkheden bekende CVE's hebben, selecteert u Doorgaan.

Als CVE's worden gevonden, probeert de agentmodus van GitHub Copilot deze te herstellen. Controleer de wijzigingen in VS Code en bepaal of u ze wilt behouden.

Nadat de CVE-controle is uitgevoerd, selecteert u Doorgaan wanneer u wordt gevraagd codegedragsconsistentie uit te voeren.

Als er problemen worden gevonden, probeert de GitHub Copilot-agentmodus deze op te lossen. Bepaal of u de wijzigingen wilt behouden of negeren.

Nadat de controles zijn voltooid, bouwt GitHub Copilot het project opnieuw en voert u de vorige controles opnieuw uit.

Als er kleine problemen blijven die geen onmiddellijke oplossingen vereisen, is de upgrade voltooid. Anders pakt GitHub Copilot ze alsnog aan.

Bekijk het overzicht

Na de upgrade genereert het hulpprogramma een samenvatting in het summary.md-bestand , dat de volgende informatie bevat:

• Projectgegevens.
• Regels van de code gewijzigd.
• Afhankelijkheden bijgewerkt.
• Samengevatte codewijzigingen.
• Beveiligings- en code-inconsistentieproblemen opgelost, indien van toepassing.
• Niet-opgeloste kleine CVE-problemen.

Volgende stap

Quickstart: eenheidstests genereren met modernisering van GitHub Copilot-apps