Eseguire la migrazione a Cloud Code for IntelliJ

Questo documento descrive come eseguire la migrazione del progetto App Engine basato su IntelliJ a Cloud Code for IntelliJ.

Attenzione: Cloud Code supporta fino agli ambienti di runtime Java 8. A partire dal 31 gennaio 2024, il supporto di Java 8 per App Engine è terminato e verrà ritirato il 31 gennaio 2026. Di conseguenza, Cloud Code disattiva App Engine per impostazione predefinita. Per attivare App Engine nell'IDE, vai a Impostazioni > Google Cloud Code > App Engine. A causa del ritiro imminente di App Engine, non consigliamo di creare nuovi progetti App Engine. Per ulteriori informazioni sul ritiro di App Engine, consulta la sezione Funzionalità deprecate. Per ulteriori informazioni sul programma di supporto del runtime per App Engine, consulta Programma di supporto del runtime.

Nota: sono supportate solo le applicazioni Java. Inoltre, per l'ambiente standard di App Engine, le applicazioni devono utilizzare il runtime Java 8.

Prima di iniziare

• Se il tuo progetto è basato su Maven o Gradle e utilizza i plug-in basati sull'SDK App Engine precedente (ad es. com.google.appengine.appengine-maven-plugin e com.google.appengine:gradle-appengine-plugin), devi prima eseguire la migrazione ai nuovi plug-in Maven e Gradle basati sull'interfaccia a riga di comando gcloud CLI.

• Il nuovo plug-in non supporta il miglioramento di Datanucleus. Se questa funzionalità è necessaria per il tuo progetto, dovrai configurare manualmente il miglioramento Datanucleus (JDO, JPA) per eseguire la migrazione a Cloud Code. Devi utilizzare Objectify come livello ORM durante la lettura/scrittura in Datastore.

Installa il nuovo plug-in

Se non lo hai ancora fatto, installa il plug-in nel seguente modo:

• Assicurati di avere la versione dell'IDE supportata, JetBrains IDE versione 2022.3 o successiva (ad esempio IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand), sul PATH della tua macchina.
• Apri IntelliJ IDEA (o qualsiasi IDE JetBrains supportato).
• Apri la finestra del marketplace dei plug-in utilizzando File > Impostazioni > Plug-in. Per Mac OS X, utilizza IntelliJ IDEA > Preferenze > Plug-in.

• Cerca il plug-in "Cloud Code" e installalo.

  Potresti dover riavviare l'IDE per attivare il plug-in.

Configura IntelliJ e il progetto

Dopo aver installato il plug-in, configura IntelliJ e il tuo progetto in modo da utilizzare il nuovo plug-in come segue:

1. Quando ricevi una notifica che indica che il nuovo plug-in è in conflitto con l'integrazione di App Engine esistente, fai clic sul link nel prompt.

   

2. Nella seguente richiesta di disattivazione del plug-in, seleziona "Disattiva e riavvia" per disattivare il plug-in App Engine e riavviare l'IDE affinché le modifiche alla configurazione del plug-in vengano applicate.

   

3. Quando ricevi una notifica che ti informa che il tuo progetto è in un vecchio formato, fai clic sull'opzione per convertire il progetto nel nuovo formato.

4. Devi eliminare le istanze App Engine Server e Cloud esistenti e ricrearle utilizzando la nuova gcloud CLI.

   1. Vai a Impostazioni > Compilazione, esecuzione, implementazione > Server applicazioni.

   2. Seleziona le istanze App Engine Dev e fai clic su Elimina (-).

   3. Fai clic su Aggiungi (+) e seleziona Server di sviluppo Google App Engine.

      

   4. Vai a Impostazioni > Compilazione, esecuzione, implementazione > Nuvole.

   5. Seleziona le istanze cloud Google App Engine e fai clic su Elimina (-).

   6. Fai clic su Aggiungi (+) per configurare un target di deployment cloud App Engine.

      

5. Se hai configurazioni di esecuzione del server locale App Engine, devi aggiornarle per utilizzare il server applicazioni appena configurato.

6. Vai a Strumenti > Cloud Code > App Engine per visualizzare l'elenco di azioni disponibili per l'esecuzione e il deployment dell'applicazione oppure consulta la documentazione per ulteriori informazioni.

7. Per i progetti basati su Maven o Gradle, assicurati di utilizzare la versione più recente dei plug-in Gradle e Maven per App Engine.

Configurazione di progetti specifici di IntelliJ

Solo per i progetti specifici di IntelliJ (ovvero i progetti che hanno configurato manualmente le impostazioni del progetto con il vecchio aspetto App Engine e non sono sincronizzati da Gradle o Maven), aggiorna le dipendenze di App Engine.

Le dipendenze di App Engine sono ancora configurate come "Librerie esterne" e fornite dalla vecchia installazione dell'SDK App Engine. Se elimini l'installazione dell'SDK App Engine, la compilation dell'applicazione non verrà eseguita.

Per rimuovere questa dipendenza dal vecchio SDK di App Engine, configura le dipendenze dell'API App Engine utilizzando la funzionalità di importazione della libreria di App Engine Facet come segue:

1. Gli utenti della funzionalità di miglioramento JDO/JPA di Datanucleus del vecchio plug-in devono eseguire il porting delle loro applicazioni su Maven o Gradle perché il miglioramento di Datanucleus non è supportato dal plug-in Cloud Code.

2. Dalla UI di IntelliJ Project Structure, vai alla scheda Dipendenze del modulo App Engine standard.

3. Rimuovi tutte le librerie correlate ad App Engine.

   

4. Nella stessa interfaccia utente della struttura del progetto, vai alla dimensione Google App Engine del modulo App Engine.

5. Nel riquadro Librerie, seleziona le dipendenze di App Engine che stai utilizzando.

   

   Questa azione recupererà automaticamente queste dipendenze da Maven Central e le aggiungerà al percorso di classe del modulo.

6. Esegui l'applicazione localmente ed esegui il deployment per verificare che la nuova configurazione funzioni.

7. A questo punto, puoi eliminare in sicurezza il vecchio SDK App Engine.

Assistenza

Per inviare un feedback o segnalare un problema nell'IDE IntelliJ, vai a Strumenti > Cloud Code > Guida / Informazioni > Invia feedback o segnala un problema per segnalare un problema su GitHub.