Schnellstart: Aktualisieren eines Java-Projekts durch GitHub Copilot-Modernisierung

Die GitHub-Copilot-Modernisierung bietet eine KI-gestützte agentenbasierte Erfahrung, die Java-Upgrade-Workflows durchgängig automatisiert – von der Projektanalyse und Plangenerierung bis hin zur Code-Transformation, Build-Validierung und CVE-Behebung.

Unterstützte Upgradeszenarien

  • Aktualisieren Sie Java Development Kit (JDK) auf Java 11, 17, 21 oder 25.
  • Führen Sie ein Upgrade von Spring Boot auf Version 4.0 durch.
  • Aktualisieren Sie Spring Framework auf Version 7.x.
  • Upgrade Java EE auf Jakarta EE, bis zum Jakarta EE 11.
  • Upgrade Azure SDK für Java.
  • Aktualisiere JUnit.
  • Aktualisieren sie Abhängigkeiten von Drittanbietern auf eine angegebene Version.

Voraussetzungen

  • Ein GitHub Konto mit aktiviertem GitHub Copilot. Sie benötigen einen Free-Tier-, Pro-, Pro+-, Business- oder Enterprise-Plan.
  • Java JDK sowohl für die Quell- als auch für die JDK-Zielversion.
  • Maven oder Gradle zum Erstellen Java Projekte.
  • Ein gitverwaltetes Java Projekt mit Maven oder Gradle.
  • Für Maven-basierte Projekte: Zugriff auf das öffentliche Maven Central Repository.

  • Installieren Sie die GitHub Copilot CLI:

    npm install -g @github/copilot

  • Installieren Sie das GitHub Copilot Modernisierungs-Plug-In:

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

Hinweis

Ein Azure Konto ist nur für die Bereitstellung von Ressourcen auf Azure erforderlich und wird nicht benötigt, wenn GitHub Copilot Modernisierung verwendet wird, um Codeänderungen vorzunehmen.

Wenn Sie Gradle verwenden, wird nur der Gradle-Wrapper, Version 5 oder höher, unterstützt.

Die Kotlin Domain Specific Language (DSL) wird nicht unterstützt.

Wählen Sie ein Java Projekt aus, um ein Upgrade durchzuführen.

Wählen Sie für dieses Lernprogramm eines der folgenden Beispielrepositorys aus:

Starten des Upgrades

Führen Sie die folgenden Schritte aus, um den Upgradevorgang zu starten:

  1. Öffnen Sie das ausgewählte Java Projekt in Visual Studio Code.

  2. Öffnen Sie in der Randleiste den Bereich GitHub Copilot Modernization, um die Schnellstartseite anzuzeigen.

  3. Wählen Sie Upgrade Java Runtime & Frameworks.

    Diese Aktion öffnet GitHub Copilot Chat im Agentmodus und startet den Upgradevorgang automatisch.

    Tipp

    Sie können auch eine bestimmte Aufgabe aus der Aufgabenstruktur unterhalb des Schnellstartpanels (z. B. Upgrade Spring Boot Version oder Upgrade Jakarta EE Version) auswählen, um ein gezieltes Upgrade auszulösen.

    Alternativ können Sie direkt im GitHub Copilot Chat im Agentmodus eingeben – zum Beispiel "Aktualisiere mein Java-Projekt auf Java 21" –, um das Upgrade zu starten.

Screenshot von Visual Studio Code, der die QuickStart-Seite mit der Schaltfläche „Upgrade Java Runtime & Frameworks“ zeigt.

Führen Sie die folgenden Schritte aus, um den Upgradevorgang zu starten:

  1. Öffnen Sie das ausgewählte Java Projekt in IntelliJ IDEA.

  2. Öffnen Sie in der Randleiste den Bereich GitHub Copilot Modernization, um die Schnellstartseite anzuzeigen.

  3. Wählen Sie Upgrade Runtime & Frameworks aus.

    Diese Aktion öffnet GitHub Copilot Chat im Agentmodus und startet den Upgradevorgang automatisch.

    Tipp

    Sie können auch direkt in GitHub-Copilot Chat mithilfe des Agentmodus eingeben , z. B. "Upgrade meines Java Projekts auf Java 21" -, um das Upgrade zu starten.

Screenshot von IntelliJ IDEA, der das GitHub Copilot-Modernisierungs-Panel mit Upgradeaufgaben und das Chat-Panel zeigt, während der Upgradeprozess ausgeführt wird.

Führen Sie die folgenden Schritte aus, um den Upgradevorgang zu starten:

  1. Öffnen Sie ein Terminal, und navigieren Sie zu Ihrem Java Projektverzeichnis.

  2. Führen Sie den Upgradebefehl aus:

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

  3. Nachdem der Agent gestartet wurde, geben Sie Ihre Upgradeanforderung ein:

    upgrade to Java 21 + Spring Boot 3.5.x

Screenshot eines Terminals, das zeigt, wie die Copilot CLI mit dem modernize-java-Agenten ein Java-Upgrade startet.

Auswählen von Upgradezielen

Nachdem Sie das Upgrade gestartet haben, werden Sie vom Agent aufgefordert, Ihre Zielversionen auszuwählen. Wählen Sie die gewünschte Java Version und ggf. die Spring Boot-Version für Ihr Projekt aus.

Screenshot von Visual Studio Code, der die Aufforderung zur Auswahl der Ziel-Java-Version mit den Optionen Java 21, 17 und 25 zeigt.

Überprüfen und Bearbeiten des Upgradeplans

GitHub Copilot analysiert das Java-Projekt im aktuellen Arbeitsbereich, einschließlich seines JDKs, seiner Build-Tools und seiner Abhängigkeiten. Das Tool generiert eine plan.md Datei, die Folgendes umfasst:

  • Verfügbare Tools – erkannte JDKs und Buildtools in Ihrer Umgebung.
  • Richtlinien – vom Benutzer angegebene Einschränkungen für den Upgradeprozess.
  • Optionen – Arbeitszweig und Testkonfiguration.
  • Upgradeziele – Quell- und Zielversionen für jede Komponente.
  • Technologiestapel – Abhängigkeitskompatibilitätsanalyse mit Inkompatibilitätsgründen.
  • Abgeleitete Upgrades — zusätzliche Upgrades, die von den primären Zielen erfordert werden (z. B. die Migration vom javax- zum jakarta-Namespace beim Upgrade auf Spring Boot 3.x).
  • Auswirkungsanalyse – detaillierte Aufschlüsselung von Abhängigkeitsänderungen, Quellcodeänderungen, Konfigurationsänderungen, CI/CD-Änderungen und Risiken.
  • Upgradeschritte – sortierte Migrationsschritte mit Rationalisierungs- und Überprüfungskriterien.

Überprüfen Sie den Plan, und nehmen Sie bei Bedarf Änderungen vor, und bestätigen Sie dann, dass Sie fortfahren möchten. Informationen zu weiteren Anpassungen finden Sie unter Anpassen des Upgradeplans.

Tipp

Stellen Sie sicher, dass der Plan Ihren gewünschten Upgradezielen entspricht , z. B. Java 8 bis Java 21, Spring Boot 1.5 bis 3.5.

Screenshot von Visual Studio Code, der die Datei plan.md mit Upgradezielen und Technologie-Stack zeigt.

Ausführen des Upgrades

Nachdem Sie den Plan bestätigt haben, fährt der Agent automatisch mit der Codetransformationsphase fort. Im Rahmen dieses Prozesses werden die folgenden Aufgaben ausgeführt:

  • Ändert Code- und Konfigurationsdateien, um die Kompatibilität mit den Zielversionen sicherzustellen.
  • Führt die Buildüberprüfung aus, um zu bestätigen, dass das Projekt bei jedem Schritt erfolgreich kompiliert wird.
  • Führt die Testüberprüfung aus, wenn sie in den Planoptionen aktiviert ist.

Der Agent durchläuft jeden Upgradeschritt, bis alle Schritte erfolgreich abgeschlossen wurden. Sie können den Fortschritt jederzeit überwachen, indem Sie die progress.md Datei im Editor überprüfen.

Screenshot von Visual Studio Code, das die progress.md-Datei mit dem Status des Upgradeschritts zeigt.

CVE-Überprüfung und -Korrektur

Nach Abschluss der Schritte zur Codetransformation prüft der Agent automatisch die Abhängigkeiten auf Common Vulnerabilities and Exposures (CVE). Falls CVEs gefunden werden, behebt der Agent sie durch die Aktualisierung der betroffenen Abhängigkeiten – ein manueller Eingriff ist nicht erforderlich. Der letzte Überprüfungsschritt wird dann ausgeführt, um zu bestätigen, dass nach den CVE-Korrekturen noch alles erstellt und Tests bestanden wird.

Sehen Sie sich die Zusammenfassung an

Nach dem Upgrade generiert das Tool eine summary.md Datei, die Folgendes umfasst:

  • Zusammenfassung der Geschäftsleitung – eine Ein-Absatz-Übersicht über das Upgrade und das Ergebnis.
  • Upgradeverbesserungen – eine Vor-/Nachher-Vergleichstabelle mit wichtigen Vorteilen.
  • Build und Validierung – Buildstatus und Testergebnisse.
  • Einschränkungen – alle nicht behebtbaren Probleme, die nach dem Upgrade verbleiben.
  • Empfohlene nächste Schritte — vorgeschlagene Folgemaßnahmen, wie das Generieren von Unit-Tests oder das Beheben noch verbleibender, nicht behobener CVEs.
  • Weitere Details – Projektmetadaten, Codeänderungen und CVE-Überprüfungsergebnisse.

Screenshot von Visual Studio Code, in dem der Zusammenfassungsinhalt des Upgrades angezeigt wird.

Screenshot von IntelliJ IDEA, in dem die Upgradezusammenfassung mit Java Upgradeergebnis und dem Chatbereich mit dem Upgradeabschluss angezeigt wird.

Screenshot eines Terminals, der die Zusammenfassung des Upgrades mit Dateiänderungen nach Abschluss eines Upgrades von Java 11 auf 21 und von Spring Boot 2.7 auf 3.5 zeigt.

Nächster Schritt

Quickstart: Erstellen von Unittests mit GitHub Copilot Modernization

  • Last updated on