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 applicazioni Java a versioni di linguaggio 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 anzitutto lo scrive nella versione del linguaggio di origine e verifica di avere le informazioni necessarie per eseguire la trasformazione. Dopo che Amazon Q ha trasformato correttamente il codice, puoi verificare e accettare 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 codice, consulta Come 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 delle 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 le fasi in Configurazione di Amazon Q nell’IDE in uso.

Prima di iniziare un processo di trasformazione del codice, verifica che siano soddisfatti i seguenti requisiti preliminari:

Fase 2: configurare il progetto

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

Configurare un progetto in JetBrains

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

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

Per ulteriori informazioni, consulta Project structure settings e Module structure settings nella documentazione di JetBrains.

Configurare un progetto in VS Code

Per configurare il progetto in VS Code, il progetto deve contenere quanto segue:

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

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

Una volta installato Maven, aggiungilo alla variabile PATH. Per ulteriori informazioni, consulta Come faccio ad aggiungere Maven al mio PATH? Inoltre, la variabile runtime di Java dovrebbe puntare a un JDK e non a un JRE. Per confermare che la configurazione sia corretta, esegui mvn -v. L’output dovrebbe mostrare la versione Maven e la variabile di runtime che punta al percorso del JDK.

Fase 3: creazione di un file di aggiornamento delle dipendenze (facoltativo)

Puoi fornire ad Amazon Q un file di aggiornamento delle dipendenze, un file YAML che elenca le dipendenze del 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 aggiornare.

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 dipendenze proprietarie quando esegue le build nell’ambiente locale. Per ulteriori informazioni, consulta Compilazione del codice nell’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 aggiornamento 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 desideri fornirne uno, assicurati innanzitutto di aver configurato correttamente il file. Nel file YAML sono obbligatori i seguenti campi:

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: trasformazioni di codice

Per testare la configurazione IDE, scarica e decomprimi il progetto di esempio e completa le fasi seguenti per l’IDE. Se riesci a visualizzare le modifiche proposte e il riepilogo delle trasformazioni, è tutto pronto per trasformare il tuo progetto di codice. Se la trasformazione no riesce, l’IDE non è configurato correttamente. Per risolvere i problemi di configurazione, consulta Fase 2: configurare il progetto e Risoluzione dei problemi.

Completa la procedura seguente per l’IDE per aggiornare la versione di linguaggio del codice di progetto o modulo di codice.

JetBrains

1. Apri il modulo che desideri aggiornare in JetBrains. Assicurati di aver creato correttamente il tuo progetto nell’IDE.

2. Scegli il logo Amazon Q e chiedi ad Amazon Q di trasformare la tua applicazione nel pannello di chat che si apre.

3. Viene visualizzato un pop-up Trasforma la tua applicazione. Scegli il progetto che desideri aggiornare dall’elenco a tendina, quindi scegli Trasformazioni.

4. Amazon Q richiede di fornire un file delle dipendenze 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 in Fase 3: creazione di un file di aggiornamento delle dipendenze (facoltativo).

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 delle differenze 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 corso.

8. Per ottenere dettagli su come è stato aggiornato il codice e sulle fasi successive suggerite, nella scheda Dettagli della trasformazione, scegli Visualizza riepilogo della trasformazione.

Visual Studio Code

1. Apri il progetto o lo spazio di lavoro di cui desideri eseguire l’aggiornamento in VS Code. Assicurati di aver creato correttamente il tuo progetto nell’IDE.

2. Scegli il logo Amazon Q e chiedi ad Amazon Q di trasformare la tua applicazione nel pannello di chat 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. Per procedere, scegli la versione in cui è scritto il codice sorgente, quindi scegli Trasforma.

5. Se richiesto, immetti il percorso JAVA_HOME nel JDK. Per ulteriori informazioni, consulta Configure your VS Code project.

6. Amazon Q richiede di fornire un file delle dipendenze 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 in Fase 3: creazione di un file di aggiornamento delle dipendenze (facoltativo).

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

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 delle differenze 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 sulle fasi successive suggerite, nell’Hub di trasformazione, scegli il pulsante con i puntini di sospensione Visualizzazioni e altre azioni, quindi scegli Mostra riepilogo della trasformazione.