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 Java con Amazon Q Developer

Amazon Q Developer può aggiornare le tue applicazioni Java a versioni linguistiche più recenti nell'ambiente di sviluppo integrato (IDE). Le modifiche che Amazon Q può apportare per aggiornare il codice includono l'aggiornamento di componenti di codice obsoleti e APIs l'aggiornamento di librerie, framework e altre dipendenze nel codice.

Per trasformare il codice, Amazon Q crea innanzitutto il codice nella versione in lingua di origine e verifica che disponga delle informazioni necessarie per eseguire la trasformazione. Dopo che Amazon Q ha trasformato correttamente il tuo codice, verifichi e accetti le modifiche nel tuo IDE. Poiché Amazon Q Developer apporta le modifiche minime necessarie per rendere il codice aggiornato compatibile con il JDK di destinazione, è necessaria un'ulteriore trasformazione per aggiornare le librerie e le dipendenze del progetto. Per ulteriori informazioni su come Amazon Q trasforma il tuo codice, consultaIn che modo Amazon Q Developer trasforma il codice per gli aggiornamenti del linguaggio Java.

Aggiornamenti Java supportati e IDEs

Amazon Q attualmente supporta le seguenti versioni del codice sorgente Java e versioni di destinazione per le trasformazioni. La trasformazione del codice nella stessa versione di Java include l'aggiornamento delle librerie e di altre dipendenze nella versione del codice sorgente.

Amazon Q supporta gli aggiornamenti Java nei seguenti casi: IDEs

Fase 1: prerequisiti

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

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

Passaggio 2: configura il tuo progetto

Per configurare il progetto, utilizza le seguenti informazioni per l'IDE che stai utilizzando.

Configura un progetto in JetBrains

Per configurare il progetto inJetBrains, potrebbe essere necessario specificare le seguenti impostazioni del progetto e del modulo.

Se i moduli utilizzano lo stesso JDK e lo stesso livello di lingua del progetto, non è necessario aggiornare le impostazioni del modulo.

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

Configura un progetto in VS Code

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

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, vedi Come faccio ad aggiungere Maven al mio? PATH La tua runtime variabile Java dovrebbe puntare anche a un JDK e non a un JRE. Per confermare che la configurazione è corretta, esegui. mvn -v L'output dovrebbe mostrare la tua Maven versione e la runtime variabile che punta al percorso del tuo JDK.

Fase 3: Creare un file di aggiornamento delle dipendenze (opzionale)

Puoi fornire ad Amazon Q un file di aggiornamento delle dipendenze, un file YAML che elenca le dipendenze del tuo progetto e le versioni a cui eseguire l'aggiornamento durante una trasformazione. Fornendo un file di aggiornamento delle dipendenze, puoi specificare dipendenze di terze e prime parti che Amazon Q potrebbe altrimenti non conoscere per l'aggiornamento.

Le dipendenze di prime parti si riferiscono alle librerie, ai plugin e ai framework gestiti dall'organizzazione e sono disponibili solo localmente o sulla rete privata dell'organizzazione. Amazon Q è in grado di accedere alle tue dipendenze proprietarie quando esegue build nel tuo ambiente locale. Per ulteriori informazioni, consulta Creazione di codice nel tuo ambiente locale. Le dipendenze di terze parti sono disponibili pubblicamente o sono dipendenze open source che non sono esclusive della tua organizzazione.

Puoi specificare le dipendenze di prime parti che desideri aggiornare in un file YAML e Amazon Q le aggiorna durante l'aggiornamento JDK (ad esempio, da Java 8 a 17). Puoi avviare una trasformazione separata (da 17 a 17 o da 21 a 21) dopo l'aggiornamento iniziale di JDK per aggiornare le dipendenze di terze parti.

Una volta che Amazon Q ha eseguito un upgrade JDK minimo, puoi avviare una trasformazione separata per aggiornare tutte le dipendenze di terze parti. In alternativa, puoi specificare le dipendenze di terze parti e le relative versioni in un file YAML per aggiornare tali dipendenze solo durante la trasformazione dell'aggiornamento della libreria.

Amazon Q ti chiederà di fornire un file di aggiornamento delle dipendenze durante la trasformazione. Se vuoi fornirne uno, assicurati innanzitutto di aver configurato correttamente il file. I seguenti campi sono obbligatori nel file YAML:

Di seguito è riportato un esempio di file YAML per l'aggiornamento delle dipendenze e la configurazione richiesta per l'analisi di Amazon Q:

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"  

Fase 4: Trasforma il codice

Prima di trasformare il tuo codice, potresti voler verificare che l'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 configurazione IDE, scarica e decomprimi il progetto di esempio, e completa i seguenti passaggi per il tuo IDE. Se riesci a visualizzare le modifiche proposte e il riepilogo delle trasformazioni, sei pronto a trasformare il tuo progetto di codice. Se la trasformazione fallisce, l'IDE non è configurato correttamente. Per risolvere i problemi di configurazione, Passaggio 2: configura il tuo progetto consulta eRisoluzione dei problemi.

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

JetBrains

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

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 dall'elenco a discesa, quindi scegli Trasforma.

4. Amazon Q richiede di fornire un file di dipendenza per l'aggiornamento. Se hai configurato un YAML con le dipendenze e la versione a cui eseguire l'aggiornamento, aggiungi il file. Amazon Q convaliderà il file per garantire che sia configurato correttamente. Se ricevi un errore, controlla il formato e i campi obbligatori descritti inFase 3: Creare un file di aggiornamento delle dipendenze (opzionale).

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

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

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

8. 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 nell'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 dell'IDE.

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 progetto. VS Code

6. Amazon Q richiede di fornire un file di dipendenza per l'aggiornamento. Se hai configurato un YAML con le dipendenze e la versione a cui eseguire l'aggiornamento, aggiungi il file. Amazon Q convaliderà il file per garantire che sia configurato correttamente. Se ricevi un errore, controlla il formato e i campi obbligatori descritti inFase 3: Creare un file di aggiornamento delle dipendenze (opzionale).

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

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

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

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