Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
GitHub Copilot ondersteunt met het moderniseren van Java-upgrades de volgende scenario's:
- Upgrade Java Development Kit (JDK) naar Java 11, 17, 21 of 25.
- Upgrade Spring Boot tot versie 3.5.
- Upgrade Spring Framework tot versie 6.2+.
- Upgrade Java EE naar Jakarta EE, tot Jakarta EE 10.
- Werk JUnit bij.
- Upgrade afhankelijkheden van derden naar een opgegeven versie.
- Ant upgraden naar Maven-build.
In deze quickstart ziet u hoe u een Java project bijwerkt met behulp van GitHub Copilot modernisering.
Vereiste voorwaarden
- Een GitHub-account waarvoor GitHub Copilot is ingeschakeld. Een Gratis-abonnement, 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 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. Moet versie 2023.3 of hoger zijn.
- GitHub Copilot. Moet versie 1.5.59 of hoger zijn. 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.
- De nieuwste versie van Visual Studio Code. Moet versie 1.101 of hoger zijn.
- 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.
- Controleer in de Visual Studio Code-instellingen of
chat.extensionTools.enabledis ingesteld optrue. Deze instelling kan worden beheerd door uw organisatie.
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.
De functie My Skills wordt nog niet ondersteund voor IntelliJ IDEA.
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 pictogram Copilot boven aan Visual Studio Code om toegang te krijgen tot het deelvenster GitHub Copilot. Zie Set up GitHub Copilot in VS Code voor meer informatie over het instellen van GitHub Copilot.
Gebruik vervolgens de volgende stappen om de extensie in Visual Studio Code te installeren:
- Open in Visual Studio Code de weergave Extensions op de activiteitenbalk.
- Zoek naar GitHub Copilot modernisatie in de marktplaats.
- Selecteer GitHub Copilot modernisatie.
- Selecteer Installeren op de extensiepagina.
- Start Visual Studio Code opnieuw op.
Aanbeveling
Om de beste ervaring in IntelliJ te krijgen, raden we u aan een aantal belangrijke instellingen te configureren. Zie voor meer informatie Instellingen configureren voor de modernisering van GitHub Copilot om de ervaring voor IntelliJ te optimaliseren.
Nadat de installatie is voltooid, ziet u een melding in de hoek van Visual Studio Code die bevestigt dat het is geslaagd.
Zie Een VS Code-extensie installeren voor meer informatie.
Selecteer een Java-project om een upgrade uit te voeren
Voor deze zelfstudie kiest u een van de volgende voorbeeldopslagplaatsen:
- Maven: uportal-messaging
- Gradle: docraptor-java
Lanceer GitHub Copilot Agentmodus en start de upgrade
Gebruik de volgende stappen om GitHub Copilot agentmodus te starten en het upgradeproces te starten:
Open het geselecteerde Java project in Visual Studio Code.
Open het deelvenster GitHub Copilot Chat.
Schakel over naar de agentmodus.
Voer een prompt in, zoals Upgrade-project naar Java 21 met behulp van Java upgradehulpprogramma's of Upgrade-project naar Java 21 en Spring Boot 3.2 met behulp van Java upgradehulpprogramma's om frameworkgegevens op te nemen.
Opmerking
Zie Upgrade van een framework of een afhankelijkheid van derden met behulp van GitHub Copilot modernisering als u alleen een framework of een afhankelijkheid van derden moet upgraden.
Wanneer u hierom wordt gevraagd, selecteert u Doorgaan om een upgradeplan te genereren.
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 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.
Aanbeveling
Zorg ervoor dat het plan overeenkomt met de gewenste upgradedoelen, bijvoorbeeld Java 8 tot Java 21, Spring Boot 2.7 tot en met 3.2.
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 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, selecteer Ga door om Java-code te upgraden 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 itereert 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.
Selecteer Doorgaan wanneer GitHub Copilot vraagt Voer validatie uit als er gemodificeerde afhankelijkheden zijn met bekende CVEs.
Wanneer CVE's worden gevonden, probeert GitHub Copilot Agent Mode 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 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 op en voert 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:
- Projectinformatie.
- 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: unittests genereren met de modernisering door GitHub Copilot