Guida introduttiva: Aggiornare un progetto Java con la modernizzazione delle app Copilot di GitHub

Gli aggiornamenti Java per la modernizzazione delle app supportano gli scenari seguenti:

• Aggiornare Java Development Kit (JDK) a Java 8, 11, 17, 21 o 25.
• Aggiornare Spring Boot alla versione 3.5.
• Aggiornare Spring Framework alla versione 6.2+.
• Aggiornare Java EE a Jakarta EE, fino alla versione Jakarta EE 10.
• Aggiornare JUnit.
• Aggiornare le dipendenze di terze parti a una versione specificata.
• Aggiornare Ant alla compilazione Maven.

Questa procedura di avvio rapido illustra come aggiornare un progetto Java usando la modernizzazione del progetto di GitHub Copilot.

Prerequisites

• Un account GitHub con GitHub Copilot abilitato. È necessario un piano Gratuito, Pro, Pro+, Business o Enterprise.
• Uno degli IDE seguenti:
  • Versione più recente di Visual Studio Code. Deve essere la versione 1.101 o successiva.
    • GitHub Copilot in Visual Studio Code. Per istruzioni sulla configurazione, vedere Configurare GitHub Copilot in Visual Studio Code. Assicurarsi di accedere all'account GitHub in Visual Studio Code.
    • Modernizzazione delle app Copilot di GitHub. Riavviare Visual Studio Code dopo l'installazione.
  • La versione più recente di IntelliJ IDEA. Deve essere la versione 2023.3 o successiva.
    • GitHub Copilot. Deve essere la versione 1.5.59 o successiva. Per altre istruzioni, vedere Configurare GitHub Copilot in IntelliJ IDEA. Assicurarsi di accedere all'account GitHub all'interno di IntelliJ IDEA.
    • Modernizzazione delle app Copilot di GitHub. Riavviare IntelliJ IDEA dopo l'installazione. Se GitHub Copilot non è installato, è possibile installare direttamente la modernizzazione dell'app GitHub Copilot.
    • Per un uso più efficiente di Copilot nella modernizzazione delle app: nelle impostazioni IntelliJ IDEA selezionare la finestra Strumenti> di configurazionedi GitHub Copilot e quindi selezionare Approva automaticamente e Considera annotazioni degli strumenti MCP. Per altre informazioni, vedere Configurare le impostazioni per la modernizzazione delle app Copilot di GitHub per ottimizzare l'esperienza per IntelliJ.
• Java JDK per le versioni JDK di origine e di destinazione.
• Maven o Gradle per compilare progetti Java.
• Un progetto Java gestito da Git usando Maven o Gradle.
• Per i progetti basati su Maven: accesso al repository Maven Central pubblico.
• Nelle impostazioni di Visual Studio Code verificare che chat.extensionTools.enabled sia impostato su true. Questa impostazione potrebbe essere controllata dall'organizzazione.

Note

Se si usa Gradle, è supportato solo il wrapper Gradle versione 5+. Il linguaggio DSL (Domain Specific Language) di Kotlin non è supportato.

La funzione My Tasks non è ancora supportata per IntelliJ IDEA.

Accedere per usare Copilot e quindi installare l'estensione richiesta

Per usare GitHub Copilot, accedere all'account GitHub in Visual Studio Code. Selezionare l'icona copilota nella parte superiore di Visual Studio Code per accedere al riquadro GitHub Copilot. Per altre informazioni sulla configurazione di GitHub Copilot, vedere Configurare GitHub Copilot in VS Code.

Usare quindi la procedura seguente per installare l'estensione in Visual Studio Code:

1. In Visual Studio Code aprire la visualizzazione Estensioni dalla barra delle attività.
2. Cercare la modernizzazione delle app Copilot di GitHub nel marketplace.
3. Selezionare Modernizzazione delle app Copilot di GitHub.
4. Nella pagina dell'estensione selezionare Installa.
5. Riavviare Visual Studio Code.

Tip

Per ottenere un'esperienza ottimale in IntelliJ, è consigliabile configurare alcune impostazioni chiave. Per altre informazioni, vedere Configurare le impostazioni per la modernizzazione delle app Copilot di GitHub per ottimizzare l'esperienza per IntelliJ.

Al termine dell'installazione, verrà visualizzata una notifica nell'angolo di Visual Studio Code che conferma l'esito positivo.

Per altre informazioni, vedere Installare un'estensione di VS Code.

Selezionare un progetto Java da aggiornare

Ai fini di questa esercitazione, scegliere uno dei repository di esempio seguenti:

• Maven: uportal-messaging
• Gradle: docraptor-java

Avviare la modalità agente di GitHub Copilot e avviare l'aggiornamento

Seguire questa procedura per avviare la modalità agente di GitHub Copilot e avviare il processo di aggiornamento:

1. Aprire il progetto Java selezionato in Visual Studio Code.

2. Aprire il pannello GitHub Copilot Chat.

3. Passare alla modalità agente.

4. Immettere un prompt, ad esempio Aggiorna progetto a Java 21 usando gli strumenti di aggiornamento Java o Aggiorna progetto a Java 21 e Spring Boot 3.2 usando gli strumenti di aggiornamento Java per includere le informazioni sul framework.

   Note

   Se è necessario aggiornare solo un framework o una dipendenza di terze parti, vedere Aggiornare un framework o una dipendenza di terze parti usando la modernizzazione dell'app GitHub Copilot.

5. Quando richiesto, selezionare Continua per generare un piano di aggiornamento.

Esaminare e modificare il piano di aggiornamento

La modernizzazione delle app Copilot di GitHub analizza il progetto Java nell'area di lavoro corrente, tra cui JDK, strumenti di compilazione e dipendenze. Lo strumento genera un file plan.md che delinea le modifiche pianificate seguenti:

• Versioni di JDK di origine e di destinazione.
• Percorsi di aggiornamento del framework e della libreria.

Esaminare il piano e apportare modifiche, se necessario, quindi selezionare Continua per continuare. Per informazioni su altre personalizzazioni, ad esempio l'aggiunta di altri parametri dello strumento di compilazione, vedere Personalizzare il piano di aggiornamento.

Tip

Assicurarsi che il piano corrisponda alle destinazioni di aggiornamento desiderate, ad esempio Java 8 a Java 21, Spring Boot 2.7 e 3.2.

Applicare modifiche al codice e risolvere i problemi di compilazione

GitHub Copilot procede quindi con la fase di trasformazione del codice del progetto. Usa uno strumento open source denominato OpenRewrite per implementare alcune modifiche al codice in base a ricette specifiche. L'intelligenza artificiale risolve quindi i problemi rimanenti tramite un ciclo di compilazione/correzione dinamico. È possibile monitorare lo stato di avanzamento nell'area dell'editor di Visual Studio Code controllando il file markdown progress.md in qualsiasi momento.

In varie fasi del processo, GitHub Copilot richiede di continuare.

Per confermare il passaggio di trasformazione OpenRewrite , selezionare Continua per aggiornare il codice Java usando OpenRewrite. Questo passaggio potrebbe richiedere alcuni minuti.

Per il passaggio Approva il ciclo di compilazione/correzione dinamico , selezionare Continua per compilare il progetto e correggere gli errori.

Copilot scorre e continua a correggere gli errori fino a quando non sono presenti altri problemi. Lo stato di avanzamento viene visualizzato in un file progress.md . Il ciclo continua fino a quando il progetto viene costruito con successo.

Verificare la presenza di vulnerabilità e modifiche del comportamento del codice

In determinate circostanze, l'aggiornamento potrebbe causare modifiche al comportamento del codice o introdurre librerie con problemi comuni di vulnerabilità ed esposizioni (CVE). Lo strumento esegue un controllo aggiuntivo per questi problemi.

Quando GitHub Copilot richiede Esegui convalida se le dipendenze modificate hanno CVE note, selezionare Continua.

Se vengono trovati CVE, la modalità agente di GitHub Copilot tenta di correggerle. Esaminare le modifiche in VS Code e decidere se mantenerle.

Dopo il controllo CVE, quando viene richiesto di eseguire convalidare la coerenza del comportamento del codice, selezionare Continua.

Se vengono rilevati problemi, la modalità agente di GitHub Copilot prova a risolverli. Decidere se mantenere o rimuovere le modifiche.

Al termine dei controlli, GitHub Copilot ricompila il progetto ed esegue nuovamente i controlli precedenti.

Se i problemi secondari rimangono che non richiedono correzioni immediate, l'aggiornamento è completo. In caso contrario, GitHub Copilot torna ad affrontarli.

Visualizzare il riepilogo

Dopo l'aggiornamento, lo strumento genera un riepilogo nel file summary.md , che include le informazioni seguenti:

• Informazioni sul progetto.
• Righe di codice modificate.
• Dipendenze aggiornate.
• Riepilogo delle modifiche al codice.
• Correzione dei problemi di incoerenza del codice e della sicurezza CVE, se presenti.
• Problemi di CVE secondari non risolti.

Passo successivo

Guida introduttiva: Generare unit test con la modernizzazione delle app Copilot di GitHub