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, verifizieren und akzeptieren Sie die Änderungen in Ihrer IDE. Weitere Informationen darüber, wie Amazon Q Ihren Code transformiert, finden Sie unterSo transformiert Amazon Q Developer Code für Java-Sprach-Upgrades.

Themen

• Unterstützte Java-Upgrades und IDEs

• Schritt 1: Voraussetzungen

• Schritt 2: Konfigurieren Sie Ihr Projekt

• Schritt 3: Transformieren Sie Ihren Code

• So transformiert Amazon Q Developer Code für Java-Sprach-Upgrades

Unterstützte Java-Upgrades und IDEs

Amazon Q unterstützt derzeit die folgenden Java-Upgrades:

• Upgrade Java 8 und Java 11 Code für Java 17 Kode

• Upgrade Java 17 Code mit aktuellen Bibliotheken und anderen Abhängigkeiten

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

• Module in JetBrains IDEs

• Projekte und Arbeitsbereiche in Visual Studio Code

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:

• Ihr Projekt ist in einer unterstützten Version geschrieben Java Version und ist darauf aufgebaut Maven.

• Ihr Projekt baut erfolgreich mit Maven in deiner IDE. Maven 3.8 oder höher wird derzeit unterstützt.

• Ihr Projekt-Quell-JDK ist lokal verfügbar und entspricht der Version Ihres Quellcodes. Wenn Sie beispielsweise Java 8-Code transformieren, sollte Ihre lokale JDK-Installation JDK 8 sein.

• Ihr Projekt wird in 55 Minuten oder weniger erstellt.

• Ihr Projekt ist korrekt konfiguriert und die richtige JDK-Version ist angegeben. Weitere Informationen finden Sie unter Schritt 2: Konfigurieren Sie Ihr Projekt.

• Ihr Projekt benötigt keinen Zugriff auf Ressourcen in Ihrem privaten Netzwerk, einschließlich einer Virtual Private Cloud (VPC) oder eines lokalen Netzwerks. Wenn Ihr Projekt beispielsweise Komponententests enthält, die eine Verbindung zu einer Datenbank in Ihrem Netzwerk herstellen, schlägt die Transformation fehl.

• Ihr Projekt verwendet keine Plugins, die andere Sprachen als Java in Ihr Java-Projekt packen. Wenn Ihr Projekt beispielsweise zusätzlich zu Ihrem Java-Quellcode den frontend-maven-pluginfür die Ausführung von JavaScript Frontend-Code verwendet, schlägt die Transformation fehl.

• Ihr lokales Netzwerk ermöglicht Uploads in Amazon S3 S3-Buckets, die Amazon Q zur Transformation Ihres Codes verwendet. Weitere Informationen finden Sie unter Zulassen des Zugriffs auf Amazon S3 S3-Buckets in Datenperimetern.

• Ihre minimale Compilerversion für den ist v13.13.0. maven-compiler-plugin

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 zu konfigurieren in JetBrains, 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.

• Projekt-SDK — Das JDK, das zum Kompilieren Ihres Projekts verwendet wurde.

• Sprachniveau des Projekts — Das Java Version, die in Ihrem Projekt verwendet wird.

• Modul-SDK — Das JDK, das zum Kompilieren Ihres Moduls verwendet wurde.

• Sprachniveau des Moduls — Das Java Version, die in Ihrem Modul verwendet wird.

• Maven Runner JRE — Das JDK, mit dem Sie Ihr Modul erstellen.

Aktualisieren Sie die Projekt- und Moduleinstellungen

Gehen Sie wie folgt vor, um Ihr SDK und die Einstellungen für die Sprachebene für Ihr Projekt oder Modul zu aktualisieren:

1. Von Ihrem JetBrains IDE, wählen Sie Datei und dann Projektstruktur.

2. Das Fenster Projektstruktur wird geöffnet. Wählen Sie unter Projekteinstellungen die Option Projekt aus.

   1. Um Ihr Projekt-JDK zu aktualisieren, wählen Sie aus der Dropdownliste neben SDK aus.

   2. Um Ihre Projektsprache zu aktualisieren, wählen Sie aus der Dropdownliste neben Sprachstufe aus.

3. Wählen Sie unter Project Settings die Option Modules aus.

   1. Um Ihr Modul JDK zu aktualisieren, wählen Sie aus der Drop-down-Liste neben SDK aus.

   2. Um die Sprache Ihres Moduls zu aktualisieren, wählen Sie aus der Dropdownliste neben Sprachstufe aus.

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

Aktualisieren Sie die Maven-Einstellungen

Gehen Sie wie folgt vor, um Ihre Maven Runner JRE zu aktualisieren:

1. Von deinem JetBrains Wählen Sie in der IDE das Zahnradsymbol und dann im daraufhin angezeigten Menü die Option Einstellungen aus.

2. Wählen Sie im Einstellungsfenster Build, Execution, Deployment, dann Build Tools, dann Maven und dann Runner.

3. Wählen Sie im Feld JRE das JDK aus, das zum Erstellen des Moduls verwendet wurde, das Sie transformieren.

Konfigurieren Sie ein Projekt in VS Code

Um Ihr Projekt zu konfigurieren in VS Code, muss Ihr Projekt Folgendes enthalten:

• Eine pom.xml Datei im Stammordner des Projekts

• Eine .java Datei im Projektverzeichnis

Wenn Ihr Projekt eine enthält Maven Ausführbares Wrapper-Programm (mvnwfür macOS oder mvnw.cmd für Windows), stellen Sie sicher, dass es sich an der Wurzel Ihres Projekts befindet. Amazon Q verwendet den Wrapper und keinen anderen Maven Konfiguration ist erforderlich.

Wenn Sie kein verwenden Maven Wrapper, installiere Maven. Weitere Informationen finden Sie unter Installation Apache Mavenin der Apache Maven -Dokumentation.

Nach der Installation Maven, füge es zu deiner 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 deine zeigen Maven Version und die runtime Variable, die auf den Pfad zu Ihrem JDK zeigt.

Schritt 3: 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.

Anmerkung

Wenn Sie Ihre IDE verlassen, bevor die Transformation beginnt, schlägt die Transformation fehl und Sie müssen neu starten.

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öchten JetBrains. 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 beginnt mit der Transformation. Sie können den Fortschritt auf der Registerkarte Transformationsdetails einsehen.

5. Nach Abschluss der Transformation können Sie den aktualisierten Code überprüfen, bevor Sie Ihr Projekt aktualisieren. Um den neuen Code anzuzeigen, wechseln 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.

6. 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.

7. 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. Öffne das Projekt oder den Workspace, für das du ein Upgrade durchführen möchtest VS 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 Konfiguration Ihres VS Code Projekt.

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

7. 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.

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

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