Aggiornamento delle versioni linguistiche con Amazon Q Developer Agent for code transformation - Sviluppatore Amazon Q
Fase 1: prerequisitiFase 2: Configura il tuo progettoFase 3: Trasforma il codice

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiornamento delle versioni linguistiche con Amazon Q Developer Agent for code transformation

Amazon Q Developer Agent for code transformationPossono aggiornare la versione in linguaggio di codice dei file in uso. Puoi trasformare un modulo in JetBrains un progetto o un intero spazio di lavoro inVisual Studio Code.

Amazon Q crea innanzitutto il codice nella versione in lingua di origine e verifica che contenga le informazioni necessarie per trasformarlo. Dopo che Amazon Q ha trasformato correttamente il codice, verifichi e accetti le modifiche nel tuo ambiente di sviluppo integrato (IDE). Per ulteriori informazioni, consulta Come funziona Amazon Q Developer Agent for code transformation.

Attualmente, Amazon Q può aggiornare il codice Java 8 e Java 11 al codice Java 17.

Argomenti

Fase 1: prerequisiti

Prima di continuare, assicurati di aver completato i passaggi indicati in Configurare Amazon Q nel tuo IDE.

Assicurati che siano soddisfatti i seguenti prerequisiti prima di iniziare un processo di trasformazione del codice:

  • Il tuo progetto è basato su Java Maven 8 o Java 11.

  • Il tuo progetto si costruisce con successo con Maven in yourIDE. Amazon Q Developer Agent for code transformationsupporta la Maven versione 2.8, ma consigliamo la versione Maven 3.9.5 o successiva.

  • Il codice sorgente del progetto JDK è disponibile localmente ed è la versione del codice sorgente. Ad esempio, se state trasformando il codice Java 8, l'JDKinstallazione locale dovrebbe essere JDK 8.

  • Il progetto viene creato in 55 minuti o meno.

  • Il progetto è configurato correttamente e viene specificata la JDK versione corretta. Per ulteriori informazioni, consulta Fase 2: Configura il tuo progetto.

  • Il progetto non richiede l'accesso alle risorse sulla rete privata, incluso un cloud privato virtuale (VPC) o una rete locale. Ad esempio, se il progetto contiene test unitari che si connettono a un database della rete, la trasformazione avrà esito negativo.

  • Il tuo progetto non utilizza plugin che impacchettano linguaggi diversi da Java nel tuo progetto Java. Ad esempio, se il progetto utilizza il codice front-end frontend-maven-pluginper eseguire il JavaScript codice front-end oltre al codice sorgente Java, la trasformazione avrà esito negativo.

  • Il progetto non utilizza intervalli di versioni dipendenti dai pom.xml file. Ad esempio, se il pom.xml file include<version>[1.0.0,)</version>, la trasformazione avrà esito negativo. Per ulteriori informazioni, consulta la specifica dell'intervallo di versioni nella documentazione del progetto Apache Maven.

  • La tua rete locale consente il caricamento su bucket Amazon S3 che Amazon Q utilizza per trasformare il codice. Per ulteriori informazioni, consulta Consentire l'accesso ai bucket Amazon S3 nei perimetri di dati.

  • La versione minima del compilatore per è la v13.13.0. maven-compiler-plugin

Fase 2: Configura il tuo progetto

Per configurare il tuo progetto, utilizza le seguenti informazioni relative a quello IDE che stai utilizzando.

Configura un progetto in JetBrains

Per configurare il progetto inJetBrains, potrebbe essere necessario specificare le seguenti impostazioni della struttura del progetto:

  • ProgettoSDK: JDK utilizzato per compilare il progetto. Questo deve essere specificato per creare il progetto.

  • Livello linguistico del progetto: la Java lingua utilizzata nel progetto. Questo deve essere specificato se la Java versione utilizzata nel progetto è diversa dalla JDK versione in uso.

  • Livello di lingua del modulo: la Java lingua utilizzata nel modulo. Questo deve essere specificato se la Java versione utilizzata nei moduli è diversa dal progetto o dalla JDK versione.

Potrebbe essere necessario modificare queste impostazioni se ne utilizzi una versione non supportataJDK, ma il progetto o i moduli utilizzano una versione linguistica supportata. Ad esempio, se stai trasformando un progetto da Java 8, ma ne stai usando JDK 18, devi impostare il livello di lingua del progetto su 8. Java

Inoltre, se il progetto contiene più moduli che utilizzano versioni linguistiche diverse, devi impostare il livello di lingua per il modulo che stai trasformando.

Aggiorna le impostazioni del progetto

Per aggiornare le impostazioni del progettoSDK, della lingua del progetto o della lingua del modulo, completa i seguenti passaggi:

  1. Dal tuo JetBrainsIDE, scegli File e poi Struttura del progetto.

  2. Si apre la finestra Struttura del progetto. In Impostazioni del progetto, scegli Progetto.

    1. Per aggiornare il tuoJDK, scegli dal menu a discesa accanto a SDK.

    2. Per aggiornare la lingua del progetto, scegli dal menu a discesa accanto a Livello di lingua.

  3. In Project Settings (Impostazioni progetto), scegliere Modules (Moduli).

    1. Per aggiornare la lingua del modulo, scegli dal menu a discesa accanto a Livello di lingua.

Per ulteriori informazioni, consulta Impostazioni della struttura del progetto e Impostazioni della struttura del modulo nella JetBrains documentazione.

Configurare un progetto in VS Code

Per configurare il progetto inVS Code, il progetto deve contenere quanto segue:

  • Un pom.xml file nella cartella principale del progetto

  • Un .java file nella directory del progetto

Se il tuo progetto contiene un eseguibile Maven mvnw wrapper (for macOS o mvnw.cmd forWindows), assicurati che sia alla radice del tuo progetto. Amazon Q utilizzerà il wrapper e non sono necessarie altre Maven configurazioni.

Se non utilizzi un Maven wrapper, installa. Maven Per ulteriori informazioni, consulta Installazione Apache Maven nella Apache Maven documentazione.

Dopo l'installazioneMaven, aggiungila alla PATH variabile. Per ulteriori informazioni, Come faccio ad aggiungere Maven al mio? PATH consultate Anche la runtime variabile Java dovrebbe puntare a a JDK e non aJRE. Per confermare che la configurazione è corretta, mvn -v esegui. L'output dovrebbe mostrare la tua Maven versione e la runtime variabile che punta al percorso della tuaJDK.

Fase 3: Trasforma il codice

Prima di trasformare il tuo codice, potresti voler verificare che IDE sia configurato correttamente trasformando un progetto di esempio. Di seguito è riportato un esempio di GitHub progetto idoneo per la trasformazione del codice: https://github.com/aws-samples/aws-appconfig-java-sample.

Per testare la tua IDE configurazione, scarica e decomprimi il progetto di esempio, e completa i seguenti passaggi per il tuoIDE. Se riesci a visualizzare le modifiche proposte e il riepilogo delle trasformazioni, sei pronto per trasformare il tuo progetto di codice. Se la trasformazione fallisce, significa IDE che non è configurato correttamente. Per risolvere i problemi di configurazione, Fase 2: Configura il tuo progetto consulta eRisoluzione dei problemi.

Nota

Se ti allontani dal tuo sistema IDE prima dell'inizio della trasformazione, la trasformazione fallirà e dovrai riavviarla.

Per aggiornare la versione linguistica del tuo progetto o modulo di codice, completa i seguenti passaggi perIDE...

JetBrains

  1. Apri il modulo in cui desideri eseguire l'aggiornamentoJetBrains. Assicurati di aver creato con successo il tuo progetto inIDE.

  2. Scegli il logo Amazon Q, quindi accedi /transform al pannello di chat di Amazon Q che si apre.

  3. Viene visualizzato un pop-up Trasforma la tua applicazione. Scegli il progetto che desideri aggiornare dal menu a discesa, quindi scegli Trasforma.

  4. Amazon Q inizia la trasformazione. Puoi visualizzare lo stato di avanzamento nella scheda Dettagli della trasformazione.

  5. Una volta completata la trasformazione, puoi verificare il codice aggiornato prima di aggiornare il progetto. Per visualizzare il nuovo codice, vai alla scheda Dettagli della trasformazione, quindi scegli Visualizza differenze. Nella finestra Applica patch che appare, scegli un file per aprire una visualizzazione differenziale con il codice sorgente e il codice aggiornato.

  6. Per accettare le modifiche apportate da Amazon Q, scegli Visualizza differenze per aprire la finestra Applica patch. Seleziona tutti i file aggiornati e scegli OK per aggiornare il progetto in atto.

  7. Per ottenere dettagli su come è stato aggiornato il codice e sui passaggi successivi suggeriti, nella scheda Dettagli della trasformazione, scegli Visualizza riepilogo della trasformazione.

Visual Studio Code

  1. Apri il progetto o l'area di lavoro in cui desideri eseguire l'aggiornamento. VS Code Assicurati di aver creato con successo il tuo progetto in. IDE

  2. Scegli il logo Amazon Q, quindi accedi /transform al pannello di chat di Amazon Q che si apre.

  3. Scegli il progetto che desideri aggiornare dalla barra di ricerca nella parte superiore diIDE.

  4. Se Amazon Q non riesce a trovare la versione del codice sorgente, ti chiede di scegliere la versione del codice. Scegli la versione in cui è scritto il codice sorgente, quindi scegli Trasforma nel pop-up per procedere.

  5. Se richiesto, inserisci il JAVA_HOME percorso del tuo. JDK Per ulteriori informazioni, consulta Configurare il VS Code progetto.

  6. Amazon Q inizia la trasformazione. Puoi visualizzare i progressi nella scheda Transformation Hub.

  7. Una volta completata la trasformazione, si apre la scheda Modifiche proposte. Per verificare il codice aggiornato prima di aggiornare il progetto, scegli Scarica le modifiche proposte. Scegli un file per aprire una visualizzazione differenziale con il codice sorgente e il codice aggiornato.

  8. Per accettare le modifiche apportate da Amazon Q, vai alla scheda Modifiche proposte e scegli Accetta.

  9. Per ottenere dettagli su come è stato aggiornato il codice e sui passaggi successivi suggeriti, su Transformation Hub, scegli il pulsante con i puntini di sospensione Visualizzazioni e altre azioni, quindi scegli Mostra riepilogo della trasformazione.