Aktualisierung von Sprachversionen mit dem Amazon Q Developer Agent for code transformation - Amazon Q Developer
Schritt 1: VoraussetzungenSchritt 2: Konfigurieren Sie Ihr ProjektSchritt 3: Transformieren Sie Ihren Code

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.

Aktualisierung von Sprachversionen mit dem Amazon Q Developer Agent for code transformation

Das Tool Amazon Q Developer Agent for code transformation kann die Codesprachversion Ihrer Dateien an Ort und Stelle aktualisieren. Sie können ein Modul transformieren in JetBrains und ein Projekt oder ein ganzer Arbeitsbereich in Visual Studio Code.

Amazon Q erstellt Ihren Code zunächst in der Quellsprachenversion und überprüft, ob er über die Informationen verfügt, die für die Transformation Ihres Codes erforderlich sind. Nachdem Amazon Q Ihren Code erfolgreich transformiert hat, überprüfen und akzeptieren Sie die Änderungen in Ihrer integrierten Entwicklungsumgebung (IDE). Weitere Informationen finden Sie unter Wie Amazon Q Developer Agent for code transformation funktioniert.

Derzeit kann Amazon Q ein Upgrade durchführen Java 8 und Java 11 Code für Java 17 Kode.

Themen

Schritt 1: Voraussetzungen

Bevor Sie fortfahren, stellen Sie sicher, dass Sie die Schritte unter Amazon Q einrichten in Ihrem abgeschlossen habenIDE.

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

  • Ihr Projekt ist ein Java 8 oder Java 11 Projekte, auf denen aufgebaut wurde Maven.

  • Ihr Projekt baut erfolgreich auf Maven in deinemIDE. Amazon Q Developer Agent for code transformation unterstützt Maven 2.8, aber wir empfehlen Maven 3.9.5 oder später.

  • Ihre Projektquelle 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 virtuellen privaten 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 das, das IDE Sie verwenden.

Konfigurieren Sie ein Projekt in JetBrains

Um Ihr Projekt zu konfigurieren in JetBrains, müssen Sie möglicherweise die folgenden Einstellungen für die Projektstruktur angeben:

  • Projekt SDK — JDK Wird zum Kompilieren Ihres Projekts verwendet. Dies muss angegeben werden, um Ihr Projekt zu erstellen.

  • Sprachniveau des Projekts — Das Java Sprache, die in Ihrem Projekt verwendet wird. Dies muss angegeben werden, wenn Java Die in Ihrem Projekt verwendete Version unterscheidet sich von Ihrer JDK Version.

  • Sprachniveau des Moduls — Das Java Sprache, die in Ihrem Modul verwendet wird. Dies muss angegeben werden, wenn Java Die in Ihren Modulen verwendete Version unterscheidet sich von Ihrem Projekt oder Ihrer JDK Version.

Möglicherweise müssen Sie diese Einstellungen anpassen, wenn Sie eine nicht unterstützte Version verwendenJDK, Ihr Projekt oder Ihre Module jedoch eine unterstützte Sprachversion verwenden. Zum Beispiel, wenn Sie ein transformieren Java Projekt 8, aber Sie verwenden JDK 18, müssen Sie Ihr Projekt-Sprachniveau auf einstellen Java 8.

Wenn Ihr Projekt mehrere Module enthält, die unterschiedliche Sprachversionen verwenden, müssen Sie außerdem die Sprachebene für das Modul festlegen, das Sie transformieren.

Aktualisieren Sie die Projekteinstellungen

Gehen Sie wie folgt vorSDK, um die Spracheinstellungen für Ihr Projekt, Ihre Projektsprache oder Ihr 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 Ihre zu aktualisierenJDK, wählen Sie aus der Dropdownliste neben SDK.

    2. Um Ihre Projektsprache zu aktualisieren, wählen Sie aus der Drop-down-Liste neben Sprachniveau aus.

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

    1. Um die Sprache Ihres Moduls zu aktualisieren, wählen Sie aus dem Drop-down-Menü neben Sprachstufe aus.

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

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 keinen 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 a zeigen JDK und nicht auf JRE a. Führen Sie den Befehl aus, um zu überprüfen, ob Ihre Konfiguration korrekt istmvn -v. Die Ausgabe sollte deine zeigen Maven Version und die runtime Variable, die auf den Pfad zu Ihrem verweistJDK.

Schritt 3: Transformieren Sie Ihren Code

Bevor Sie Ihren eigenen Code transformieren, möchten Sie vielleicht testen, ob Ihr Code korrekt eingerichtet IDE 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 Ihr 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, IDE ist Ihr System nicht richtig konfiguriert. Um Konfigurationsprobleme zu beheben, überprüfen Sie Schritt 2: Konfigurieren Sie Ihr Projekt undFehlerbehebung.

Anmerkung

Wenn Sie von Ihrem IDE vor Beginn der Transformation abweichen, 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 IhrIDE.

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

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

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

  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 im das Projekt aus, für das Sie ein Upgrade durchführen möchtenIDE.

  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 einJDK. 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, wählen Sie im Transformation Hub die Ellipsenschaltfläche „Ansichten und weitere Aktionen“ und dann „Transformationsübersicht anzeigen“.