Esegui la migrazione a Cloud Code for IntelliJ

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

Prima di iniziare

  • Se il tuo progetto è basato su Maven o Gradle e utilizza i vecchi plug-in basati sull'SDK di App Engine (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 su gcloud CLI.

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

Installa il nuovo plug-in

Se non l'hai ancora fatto, installa il plug-in procedendo nel seguente modo:

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

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

    Potrebbe esserti richiesto di riavviare il tuo IDE per attivare il plug-in.

Configurare IntelliJ e il tuo progetto

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

  1. Quando ti viene comunicato che il nuovo plug-in è in conflitto con l'integrazione esistente di App Engine, fai clic sul link nella richiesta.

    Screenshot che mostra la notifica che indica che il plug-in è in conflitto. Fai clic su "Fai clic qui" per disattivare il plug-in.

  2. Nella richiesta di disattivazione del plug-in seguente, seleziona "Disabilita e riavvia" per disabilitare il plug-in App Engine e riavviare l'IDE per applicare le modifiche alla configurazione del plug-in.

    Screenshot che mostra il prompt in cui ti viene chiesto se desideri disabilitare il plug-in App Engine e riavviare l'IDE.

  3. Quando ricevi una notifica che indica che il formato del progetto è obsoleto, fai clic sull'opzione Converti il progetto nel nuovo formato.

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

    1. Vai a Settings (Impostazioni) > Build, Execution, Deployment > Server di applicazioni.

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

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

      Screenshot che mostra l'elenco di server di app e l'icona per eliminarli e aggiungerli.

    4. Vai a Impostazioni > Creazione, esecuzione, deployment > Cloud.

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

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

      Screenshot che mostra l'elenco di istanze cloud e le icone per eliminarle e aggiungerle.

  5. Se disponi di configurazioni di esecuzione di server locali App Engine, devi aggiornarle per utilizzare il server applicazioni appena configurato.

  6. Vai a Strumenti > Cloud Code > App Engine per visualizzare l'elenco delle azioni disponibili per l'esecuzione e il deployment dell'applicazione oppure visualizza 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 App Engine.

Configurazione di progetti specifici per IntelliJ

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

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

Screenshot che mostra l'elenco di librerie esterne.

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

  1. Gli utenti della funzionalità di miglioramento Datanucleus JDO/JPA del vecchio plug-in devono trasferire le loro applicazioni a Maven o Gradle poiché il miglioramento Datanucleus non è supportato dal plug-in Cloud Code.

  2. Dall'interfaccia utente della struttura di progetto IntelliJ, vai alla scheda delle dipendenze del modulo Standard di App Engine.

  3. Rimuovi tutte le librerie correlate ad App Engine.

    Screenshot che mostra l'elenco di librerie esterne e le icone per eliminarle.

  4. Nella stessa UI della struttura del progetto, vai al facet Google App Engine del modulo di App Engine.

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

    Screenshot che mostra l'elenco delle raccolte disponibili per la selezione.

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

  6. Esegui in locale ed esegui il deployment per verificare che la nuova configurazione funzioni.

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

Ricevi 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 oppure fai una domanda su Stack Overflow.