Schnellstart: Upgrade eines Java-Projekts mit GitHub Copilot-App-Modernisierung

Java-Upgrades der App-Modernisierung unterstützen die folgenden Szenarien:

• Aktualisieren Sie Java Development Kit (JDK) auf Java 8, 11, 17, 21 oder 25.
• Aktualisieren Sie Spring Boot auf die Version 3.5.
• Aktualisieren Sie Spring Framework auf Version 6.2+.
• Aktualisieren Sie Java EE auf Jakarta EE, bis zu Jakarta EE 10.
• Aktualisiere JUnit.
• Aktualisieren sie Abhängigkeiten von Drittanbietern auf eine angegebene Version.
• Upgrade von einem Ant-Build zu einem Maven-Build.

In dieser Schnellstartanleitung erfahren Sie, wie Sie ein Java-Projekt mithilfe der GitHub Copilot-App-Modernisierung aktualisieren.

Prerequisites

• Ein GitHub-Konto mit aktiviertem GitHub Copilot . Ein Free-Tarif, Pro-, Pro+-, Business- oder Enterprise-Tarif ist erforderlich.
• Eine der folgenden IDEs:
  • Die aktuelle Version von Visual Studio Code. Muss Version 1.101 oder höher sein.
    • GitHub Copilot in Visual Studio Code. Anweisungen zum Einrichten von GitHub Copilot finden Sie unter "Einrichten von GitHub Copilot" in Visual Studio Code. Melden Sie sich unbedingt in Visual Studio Code bei Ihrem GitHub-Konto an.
    • GitHub Copilot-App-Modernisierung. Starten Sie Visual Studio Code nach der Installation neu.
  • Die neueste Version von IntelliJ IDEA. Muss Version 2023.3 oder höher sein.
    • GitHub Copilot. Muss Version 1.5.59 oder höher sein. Weitere Anweisungen finden Sie unter Einrichten von GitHub Copilot in IntelliJ IDEA. Melden Sie sich unbedingt bei Ihrem GitHub-Konto in IntelliJ IDEA an.
    • GitHub Copilot-App-Modernisierung. Starten Sie IntelliJ IDEA nach der Installation neu. Wenn Sie GitHub Copilot nicht installiert haben, können Sie die GitHub Copilot-App-Modernisierung direkt installieren.
    • Um Copilot in der App-Modernisierung effizienter zu nutzen: Wählen Sie in den IntelliJ IDEA-Einstellungen das Konfigurationsfenster "Tools>GitHub Copilot " und dann " Auto-genehmigen" und " MCP-Toolanmerkungen vertrauen" aus. Weitere Informationen finden Sie unter Einstellungen für die Modernisierung der GitHub Copilot-App konfigurieren, um das Erlebnis für IntelliJ zu optimieren.
• Java JDK sowohl für die Quell- als auch für die JDK-Zielversion.
• Maven oder Gradle zum Erstellen von Java-Projekten.
• Ein gitverwaltetes Java-Projekt mit Maven oder Gradle.
• Für Maven-basierte Projekte: Zugriff auf das öffentliche Maven Central Repository.
• In den Visual Studio Code Einstellungen sicherstellen, dass chat.extensionTools.enabled auf true gesetzt ist. Diese Einstellung kann von Ihrer Organisation gesteuert werden.

Note

Wenn Sie Gradle verwenden, wird nur der Gradle-Wrapper Version 5+ unterstützt. Die Kotlin Domain Specific Language (DSL) wird nicht unterstützt.

Die Funktion My Tasks wird für IntelliJ IDEA noch nicht unterstützt.

Melden Sie sich an, um Copilot zu verwenden, und installieren Sie dann die erforderliche Erweiterung.

Um GitHub Copilot zu verwenden, melden Sie sich bei Ihrem GitHub-Konto in Visual Studio Code an. Wählen Sie oben in Visual Studio Code das Symbol "Copilot" aus, um auf den GitHub Copilot-Bereich zuzugreifen. Weitere Informationen zum Einrichten von GitHub Copilot finden Sie unter Einrichten von GitHub Copilot in VS Code.

Führen Sie dann die folgenden Schritte aus, um die Erweiterung in Visual Studio Code zu installieren:

1. Öffnen Sie in Visual Studio Code die Ansicht "Erweiterungen " in der Aktivitätsleiste.
2. Suchen Sie auf dem Marketplace nach gitHub Copilot-App-Modernisierung .
3. Wählen Sie die GitHub Copilot-App-Modernisierung aus.
4. Wählen Sie auf der Erweiterungsseite " Installieren" aus.
5. Starten Sie Visual Studio Code neu.

Tip

Um die beste Erfahrung in IntelliJ zu erzielen, empfehlen wir die Konfiguration einiger Schlüsseleinstellungen. Weitere Informationen finden Sie unter Einstellungen für die Modernisierung der GitHub Copilot-App konfigurieren, um das Erlebnis für IntelliJ zu optimieren.

Nach Abschluss der Installation sollte eine Benachrichtigung in der Ecke von Visual Studio Code angezeigt werden, die den Erfolg bestätigt.

Weitere Informationen finden Sie unter Installieren einer VS Code-Erweiterung.

Auswählen eines Java-Projekts zum Upgrade

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

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

Starten des GitHub Copilot Agent Mode und Starten des Upgrades

Führen Sie die folgenden Schritte aus, um den GitHub Copilot Agent Mode zu starten und den Upgradeprozess zu starten:

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

2. Öffnen Sie den GitHub Copilot-Chatbereich.

3. Wechseln Zum Agentmodus.

4. Geben Sie eine Eingabeaufforderung ein, wie z. B. Aktualisiere Projekt auf Java 21 mit Java-Upgrade-Tools oder Aktualisiere Projekt auf Java 21 und Spring Boot 3.2 mit Java-Upgrade-Tools, um Rahmenwerkinformationen einzuschließen.

   Note

   Wenn Sie ein Framework oder eine Abhängigkeit von Drittanbietern nur aktualisieren müssen, lesen Sie das Upgrade eines Frameworks oder einer Abhängigkeit von Drittanbietern mithilfe der GitHub Copilot-App-Modernisierung.

5. Wenn Sie dazu aufgefordert werden, wählen Sie "Weiter" aus, um einen Upgradeplan zu generieren.

Überprüfen und Bearbeiten des Upgradeplans

Die Modernisierung der GitHub Copilot-App analysiert das Java-Projekt im aktuellen Arbeitsbereich, einschließlich JDK, Buildtools und Abhängigkeiten. Das Tool generiert eine plan.md Datei, die die folgenden geplanten Änderungen beschreibt:

• Quell- und Zielversion von JDK.
• Framework- und Bibliotheksupgradepfade.

Überprüfen Sie den Plan, und nehmen Sie bei Bedarf Änderungen vor, und wählen Sie dann "Weiter" aus, um fortzufahren. Informationen zu weiteren Anpassungen, z. B. zum Hinzufügen weiterer Buildtoolparameter, finden Sie unter Anpassen des Upgradeplans.

Tip

Stellen Sie sicher, dass der Plan Ihren gewünschten Upgradezielen entspricht – z. B. Java 8 auf Java 21, Spring Boot 2.7 bis 3.2.

Anwenden von Codeänderungen und Beheben von Buildproblemen

GitHub Copilot fährt dann mit der Codetransformationsphase des Projekts fort. Es verwendet ein Open-Source-Tool namens OpenRewrite, um einige Codeänderungen basierend auf bestimmten Rezepten zu implementieren. Anschließend behebt KI die verbleibenden Probleme über eine dynamische Build-/Fixschleife. Sie können den Fortschritt im Editorbereich von Visual Studio Code überwachen, indem Sie die progress.md Markdowndatei jederzeit überprüfen.

In verschiedenen Phasen des Prozesses fordert GitHub Copilot Sie auf, den Vorgang fortzusetzen.

Wählen Sie für den Schritt "OpenRewrite-Transformation bestätigen " die Option "Weiter " aus, um Java-Code mit OpenRewrite zu aktualisieren. Dieser Schritt kann einige Minuten dauern.

Wählen Sie für den Schritt "Dynamische Build-/Fixschleife genehmigen " die Option "Weiter " aus, um das Projekt zu erstellen und Fehler zu beheben.

Kopilot iteriert und behebt weiterhin Fehler, bis keine Probleme mehr bestehen. Der Fortschritt wird in einer progress.md Datei angezeigt. Die Schleife wird fortgesetzt, bis das Projekt erfolgreich erstellt wurde.

Überprüfen auf Sicherheitsrisiken und Codeverhaltensänderungen

Unter bestimmten Umständen kann das Upgrade Codeverhaltensänderungen verursachen oder Bibliotheken einführen, die mit allgemeinen Sicherheitslücken und Schwachstellen (CVE) behaftet sind. Das Tool führt eine zusätzliche Überprüfung auf diese Probleme durch.

Wenn GitHub Copilot "Run Validate" auffordert, um zu überprüfen, ob geänderte Abhängigkeiten bekannte CVEs haben, wählen Sie "Weiter".

Wenn CVEs gefunden werden, versucht gitHub Copilot Agent Mode, sie zu beheben. Überprüfen Sie die Änderungen in VS Code, und entscheiden Sie, ob sie beibehalten werden sollen.

Wenn Sie nach der CVE-Überprüfung aufgefordert werden, die Konsistenz des Codeverhaltens zu validieren, wählen Sie "Weiter" aus.

Wenn Probleme gefunden werden, versucht gitHub Copilot Agent Mode, sie zu beheben. Entscheiden Sie, ob die Änderungen beibehalten oder verworfen werden sollen.

Nach Abschluss der Überprüfungen erstellt GitHub Copilot das Projekt neu und führt die vorherigen Prüfungen erneut aus.

Wenn kleinere Probleme bestehen, die keine sofortigen Korrekturen erfordern, ist das Upgrade abgeschlossen. Andernfalls kehrt GitHub Copilot zurück, um die Probleme zu lösen.

Sehen Sie sich die Zusammenfassung an

Nach dem Upgrade generiert das Tool eine Zusammenfassung in der summary.md Datei, die die folgenden Informationen enthält:

• Projektinformationen.
• Codezeilen wurden geändert.
• Aktualisierte Abhängigkeiten.
• Zusammengefasste Code-Änderungen.
• Es wurden ggf. Probleme mit CVE-Sicherheit und Codeinkonsistenz behoben.
• Nicht behobene kleinere CVE-Probleme.

Nächster Schritt

Schnellstart: Generieren von Komponententests mit GitHub Copilot-App-Modernisierung