Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Aktualisieren von Java-Versionen mit Amazon Q Developer

Amazon Q Developer kann Ihre Java-Anwendungen in der integrierten Entwicklungsumgebung (IDE) auf neuere Sprachversionen aktualisieren. Zu den Änderungen, die Amazon Q zur Aktualisierung Ihres Codes vornehmen kann, gehören die Aktualisierung veralteter Codekomponenten APIs sowie die Aktualisierung von Bibliotheken, Frameworks und anderen Abhängigkeiten in Ihrem Code.

Um Ihren Code zu transformieren, erstellt Amazon Q Ihren Code zunächst in der Quellsprachenversion und überprüft, ob er über die für die Transformation erforderlichen Informationen verfügt. Nachdem Amazon Q Ihren Code erfolgreich transformiert hat, überprüfen und akzeptieren Sie die Änderungen in Ihrer IDE. Da Amazon Q Developer die minimalen Änderungen vornimmt, die erforderlich sind, um Ihren aktualisierten Code mit dem Ziel-JDK kompatibel zu machen, ist eine zusätzliche Transformation erforderlich, um die Bibliotheken und Abhängigkeiten Ihres Projekts zu aktualisieren. Weitere Informationen darüber, wie Amazon Q Ihren Code transformiert, finden Sie unterSo transformiert Amazon Q Developer Code für Java-Sprach-Upgrades.

Unterstützte Java-Upgrades und IDEs

Amazon Q unterstützt derzeit die folgenden Java-Quellcodeversionen und Zielversionen für Transformationen. Die Transformation von Code in dieselbe Java-Version beinhaltet das Aktualisieren von Bibliotheken und anderen Abhängigkeiten in der Quellcodeversion.

Amazon Q unterstützt Java-Upgrades in den folgenden Bereichen IDEs:

Schritt 1: Voraussetzungen

Bevor Sie fortfahren, stellen Sie sicher, dass Sie die Schritte unter Amazon Q einrichten in Ihrer IDE abgeschlossen haben.

Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind, bevor Sie mit einem Codetransformationsjob beginnen:

Schritt 2: Konfigurieren Sie Ihr Projekt

Verwenden Sie zur Konfiguration Ihres Projekts die folgenden Informationen für die von Ihnen verwendete IDE.

Konfigurieren Sie ein Projekt in JetBrains

Um Ihr Projekt in zu konfigurierenJetBrains, müssen Sie möglicherweise die folgenden Projekt- und Moduleinstellungen angeben.

Wenn Ihre Module dasselbe JDK und dieselbe Sprachebene wie Ihr Projekt verwenden, müssen Sie die Moduleinstellungen nicht aktualisieren.

Weitere Informationen finden Sie in der JetBrains Dokumentation unter Einstellungen für die Projektstruktur und Einstellungen für die Modulstruktur.

Konfigurieren Sie ein Projekt in VS Code

Um Ihr Projekt in zu konfigurierenVS Code, muss Ihr Projekt Folgendes enthalten:

Wenn Ihr Projekt eine ausführbare Maven Wrapper-Datei (mvnwfür macOS oder mvnw.cmd fürWindows) enthält, stellen Sie sicher, dass sie sich im Stammverzeichnis Ihres Projekts befindet. Amazon Q verwendet den Wrapper, und es ist keine weitere Maven Konfiguration erforderlich.

Wenn Sie keinen Maven Wrapper verwenden, installieren Sie ihn. Maven Weitere Informationen finden Sie Apache Maven in der Apache Maven Dokumentation unter Installation.

Fügen Sie Maven es nach der Installation zu Ihrer PATH Variablen hinzu. Weitere Informationen finden Sie unter Wie füge ich Maven zu meinem hinzu? PATH Ihre runtime Java-Variable sollte auch auf ein JDK und nicht auf eine JRE verweisen. Führen Sie den Befehl aus, um zu überprüfen, ob Ihre Konfiguration korrekt ist. mvn -v Die Ausgabe sollte Ihre Maven Version und die runtime Variable zeigen, die auf den Pfad zu Ihrem JDK verweist.

Schritt 3: Erstellen Sie eine Abhängigkeitsupgrade-Datei (optional)

Sie können Amazon Q eine Abhängigkeits-Upgrade-Datei zur Verfügung stellen, eine YAML-Datei, in der die Abhängigkeiten Ihres Projekts und die Versionen aufgeführt sind, auf die während einer Transformation aktualisiert werden soll. Durch die Bereitstellung einer Abhängigkeits-Upgrade-Datei können Sie Abhängigkeiten von Drittanbietern und Erstanbietern angeben, von denen Amazon Q sonst möglicherweise nicht weiß, dass sie aktualisiert werden sollen.

Abhängigkeiten von Erstanbietern beziehen sich auf die Bibliotheken, Plugins und Frameworks, die Ihre Organisation verwaltet und die nur lokal oder im privaten Netzwerk Ihrer Organisation verfügbar sind. Amazon Q kann auf Ihre Erstanbieter-Abhängigkeiten zugreifen, wenn es Builds in Ihrer lokalen Umgebung ausführt. Weitere Informationen finden Sie unter Code in Ihrer lokalen Umgebung erstellen. Bei Abhängigkeiten von Drittanbietern handelt es sich um öffentlich verfügbare oder Open-Source-Abhängigkeiten, die nicht nur für Ihr Unternehmen gelten.

Sie können Abhängigkeiten von Erstanbietern, die Sie aktualisieren möchten, in einer YAML-Datei angeben, und Amazon Q aktualisiert sie während des JDK-Upgrades (z. B. Java 8 auf 17). Sie können nach dem ersten JDK-Upgrade eine separate Transformation (17 bis 17 oder 21 bis 21) initiieren, um Abhängigkeiten von Drittanbietern zu aktualisieren.

Sobald Amazon Q mindestens ein JDK-Upgrade durchgeführt hat, können Sie eine separate Transformation einleiten, um alle Abhängigkeiten von Drittanbietern zu aktualisieren. Alternativ können Sie Abhängigkeiten von Drittanbietern und deren Versionen in einer YAML-Datei angeben, um nur diese Abhängigkeiten während der Transformation des Bibliotheks-Upgrades zu aktualisieren.

Amazon Q fordert Sie während der Transformation auf, eine Upgrade-Datei für Abhängigkeiten bereitzustellen. Wenn Sie eine bereitstellen möchten, stellen Sie zunächst sicher, dass Sie die Datei richtig konfiguriert haben. Die folgenden Felder sind in der YAML-Datei erforderlich:

Im Folgenden finden Sie ein Beispiel für eine YAML-Datei für ein Abhängigkeitsupgrade und die erforderliche Konfiguration, die Amazon Q analysieren muss:

name: dependency-upgrade
  
description: "Custom dependency version management for Java migration from JDK 8/11/17 to JDK 17/21"
  
  
dependencyManagement:
  
  dependencies:
  
    - identifier: "com.example:library1"
  
      targetVersion: "2.1.0"
  
      versionProperty: "library1.version"  # Optional
  
      originType: "FIRST_PARTY"   
  
    - identifier: "com.example:library2"
  
      targetVersion: "3.0.0"
  
      originType: "THIRD_PARTY"
  
  plugins:
  
    - identifier: "com.example.plugin"
  
      targetVersion: "1.2.0"
  
      versionProperty: "plugin.version"  # Optional
            
      originType: "THIRD_PARTY"  

Schritt 4: Transformieren Sie Ihren Code

Bevor Sie Ihren eigenen Code transformieren, möchten Sie vielleicht testen, ob Ihre IDE korrekt eingerichtet ist, indem Sie ein Beispielprojekt transformieren. Im Folgenden finden Sie ein GitHub Beispielprojekt, das für eine Codetransformation in Frage kommt: https://github.com/aws-samples/aws-appconfig-java-sample.

Um Ihr IDE-Setup zu testen, laden Sie das Beispielprojekt herunter, entpacken Sie es und führen Sie die folgenden Schritte für Ihre IDE aus. Wenn Sie die vorgeschlagenen Änderungen und die Zusammenfassung der Transformation einsehen können, sind Sie bereit, Ihr eigenes Codeprojekt zu transformieren. Wenn die Transformation fehlschlägt, ist Ihre IDE nicht richtig konfiguriert. Um Konfigurationsprobleme zu beheben, überprüfen Sie Schritt 2: Konfigurieren Sie Ihr Projekt undFehlerbehebung.

Um die Sprachversion Ihres Codeprojekts oder -moduls zu aktualisieren, führen Sie die folgenden Schritte für Ihre IDE aus.

JetBrains

1. Öffnen Sie das Modul, für das Sie ein Upgrade durchführen möchtenJetBrains. Stellen Sie sicher, dass Sie Ihr Projekt erfolgreich in der IDE erstellt haben.

2. Wählen Sie das Amazon Q-Logo und geben Sie es dann /transform in das Amazon Q-Chatfenster ein, das sich öffnet.

3. Ein Popup-Fenster „Transformieren Sie Ihre Anwendung“ wird angezeigt. Wählen Sie aus der Dropdownliste das Projekt aus, das Sie aktualisieren möchten, und wählen Sie dann Transformieren aus.

4. Amazon Q fordert Sie auf, eine Upgrade-Abhängigkeitsdatei bereitzustellen. Wenn Sie ein YAML mit den Abhängigkeiten und der Version konfiguriert haben, auf die Sie aktualisieren möchten, fügen Sie Ihre Datei hinzu. Amazon Q validiert die Datei, um sicherzustellen, dass sie korrekt konfiguriert ist. Wenn Sie eine Fehlermeldung erhalten, überprüfen Sie das Format und die erforderlichen Felder, die unter beschrieben sindSchritt 3: Erstellen Sie eine Abhängigkeitsupgrade-Datei (optional).

5. Amazon Q beginnt mit der Transformation. Sie können den Fortschritt auf der Registerkarte Transformationsdetails einsehen.

6. Nach Abschluss der Transformation können Sie den aktualisierten Code überprüfen, bevor Sie Ihr Projekt aktualisieren. Um den neuen Code anzuzeigen, gehen Sie zur Registerkarte Transformationsdetails und wählen Sie dann Vergleich anzeigen. Wählen Sie im daraufhin angezeigten Fenster „Patch anwenden“ eine Datei aus, um eine Vergleichsansicht mit Ihrem Quellcode und aktualisiertem Code zu öffnen.

7. Um die von Amazon Q vorgenommenen Änderungen zu akzeptieren, wählen Sie Diff anzeigen, um das Fenster Patch anwenden zu öffnen. Wählen Sie alle aktualisierten Dateien aus und wählen Sie OK, um Ihr Projekt an Ort und Stelle zu aktualisieren.

8. Um Einzelheiten darüber zu erhalten, wie Ihr Code aktualisiert wurde, und Vorschläge für die nächsten Schritte zu erhalten, wählen Sie auf der Registerkarte Transformationsdetails die Option Transformationsübersicht anzeigen aus.

Visual Studio-Code

1. Öffnen Sie das Projekt oder den Workspace, für das Sie das Upgrade durchführen möchtenVS Code. Stellen Sie sicher, dass Sie Ihr Projekt erfolgreich in der IDE erstellt haben.

2. Wählen Sie das Amazon Q-Logo und geben Sie es dann /transform in das Amazon Q-Chatfenster ein, das sich öffnet.

3. Wählen Sie in der Suchleiste oben in der IDE das Projekt aus, das Sie aktualisieren möchten.

4. Wenn Amazon Q die Version Ihres Quellcodes nicht finden kann, werden Sie aufgefordert, Ihre Codeversion auszuwählen. Wählen Sie die Version aus, in der Ihr Quellcode geschrieben ist, und wählen Sie dann im Pop-up die Option Transformieren, um fortzufahren.

5. Wenn Sie dazu aufgefordert werden, geben Sie den JAVA_HOME Pfad zu Ihrem JDK ein. Weitere Informationen finden Sie unter VS CodeProjekt konfigurieren.

6. Amazon Q fordert Sie auf, eine Upgrade-Abhängigkeitsdatei bereitzustellen. Wenn Sie ein YAML mit den Abhängigkeiten und der Version konfiguriert haben, auf die Sie aktualisieren möchten, fügen Sie Ihre Datei hinzu. Amazon Q validiert die Datei, um sicherzustellen, dass sie korrekt konfiguriert ist. Wenn Sie eine Fehlermeldung erhalten, überprüfen Sie das Format und die erforderlichen Felder, die unter beschrieben sindSchritt 3: Erstellen Sie eine Abhängigkeitsupgrade-Datei (optional).

7. Amazon Q beginnt mit der Transformation. Sie können den Fortschritt auf der Registerkarte Transformation Hub einsehen.

8. Nach Abschluss der Transformation wird die Registerkarte Vorgeschlagene Änderungen geöffnet. Um den aktualisierten Code zu überprüfen, bevor Sie Ihr Projekt aktualisieren, wählen Sie „Vorgeschlagene Änderungen herunterladen“. Wählen Sie eine Datei aus, um eine Vergleichsansicht mit Ihrem Quellcode und aktualisiertem Code zu öffnen.

9. Um die von Amazon Q vorgenommenen Änderungen zu akzeptieren, wechseln Sie zur Registerkarte Vorgeschlagene Änderungen und wählen Sie Akzeptieren.

10. Um Einzelheiten darüber zu erhalten, wie Ihr Code aktualisiert wurde, und Vorschläge für die nächsten Schritte zu erhalten, wählen Sie im Transformation Hub die Ellipsenschaltfläche „Ansichten und weitere Aktionen“ und dann „Transformationsübersicht anzeigen“.