Esegui e esegui il debug di un'app App Engine Standard localmente in 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 il programma di supporto del runtime.

Prima di eseguire il deployment dell'applicazione in App Engine, puoi eseguire e eseguire il debug della tua applicazione standard di App Engine localmente. Questo documento descrive come configurare l'IDE per l'esecuzione e il debug locale da IntelliJ IDEA.

Nota: le seguenti IDE supportano questa funzionalità:

• IntelliJ IDEA - Ultimate
• IntelliJ IDEA - Community

Nota: per l'ambiente standard di App Engine, su Cloud Code sono supportate solo le applicazioni Java che utilizzano il runtime Java 8.

Prima di iniziare

• Assicurati che la tua applicazione sia un progetto standard di App Engine che contiene un file appengine-web.xml

• Per accedere alle librerie client di Cloud localmente, completa le procedure di aggiunta delle librerie client di Cloud ai progetti Maven.

Nota: le configurazioni di esecuzione per l'esecuzione e il debug locale sono disponibili solo in IntelliJ Ultimate Edition. Se utilizzi Community Edition, puoi seguire le istruzioni per il debug dell'applicazione localmente su Community Edition per utilizzare i plug-in Maven o Gradle per l'esecuzione locale.

Eseguire l'applicazione in locale

Se utilizzi IntelliJ IDEA Ultimate Edition, puoi eseguire un'applicazione App Engine in locale seguendo queste istruzioni:

1. Seleziona File > Apri per aprire il progetto che vuoi eseguire.

2. Vai alla directory contenente il progetto.

3. Seleziona Strumenti > Cloud Code > App Engine Esegui su un server dev App Engine Standard locale.

La creazione del progetto richiede un istante.

Modifica della configurazione di esecuzione

Configura il server

Puoi modificare la configurazione di esecuzione per il server locale:

1. Seleziona Esegui > Modifica configurazioni.

2. Nella finestra di dialogo Configurazioni di esecuzione/debug, aggiorna le impostazioni di configurazione come necessario. Alcune impostazioni comuni includono:

   • Artefatto da eseguire il deployment.
   • Host App Engine.
   • Porta App Engine.

Aggiungi variabili di ambiente

Se necessario, aggiungi variabili di ambiente alla configurazione.

1. Seleziona la scheda Avvio/Connessione.

2. Seleziona Esegui.

3. Seleziona la casella di controllo Passa le variabili di ambiente.

4. Aggiungi le variabili necessarie.

5. Seleziona Debug.

6. Seleziona la casella di controllo Passa le variabili di ambiente.

7. Aggiungi le variabili necessarie.

   

8. Al termine, fai clic su OK.

Arrestare il server

Per interrompere il server App Dev, scegli Esegui > Interrompi "Server locale Google App Engine standard".

Eseguire il debug dell'applicazione

Puoi utilizzare la configurazione di esecuzione creata in precedenza per eseguire l'applicazione in modalità di debug come segue:

1. Seleziona Esegui > Debug.

2. Nella finestra di dialogo, fai clic su Server locale Google App Engine Standard.

3. Dopo la compilazione del progetto, puoi impostare i punti di interruzione per eseguire il debug dell'app.

Eseguire il debug dell'applicazione in locale nella versione Community Edition

IntelliJ Community Edition non fornisce il supporto integrato per l'esecuzione di applicazioni Java basate su servlet locali. Per eseguire il debug dell'applicazione localmente utilizzando IntelliJ Community Edition, configura il progetto in modo da utilizzare il plug-in Maven o Gradle.

Maven

Configurazione del progetto utilizzando il plug-in Maven

1. Aggiungi il plug-in Maven App Engine al file pom.xml del progetto.

2. Configura il debug su un server di sviluppo.

3. Crea la configurazione di esecuzione/debug per Maven.

   

   1. Seleziona Esegui > Modifica configurazioni.

   2. Fai clic su + Aggiungi nuova configurazione.

   3. Seleziona Maven.

   4. Nel campo Linea di comando, inserisci appengine:run.

   5. Fai clic su OK.

4. Crea una configurazione di debug remoto.

   

   1. Seleziona Esegui > Modifica configurazioni.

   2. Fai clic su + Aggiungi nuova configurazione.

   3. Seleziona Telecomando.

   4. Assicurati che il numero di porta corrisponda a quello configurato nel plug-in Maven App Engine. La porta 5005 è quella predefinita.

   5. Nella sezione Prima del lancio, fai clic su + Aggiungi.

   6. Seleziona Esegui un'altra configurazione.

   7. Seleziona la configurazione di esecuzione per il progetto Maven.

   8. Fai clic su OK.

5. Per eseguire il debug dell'applicazione in locale:

   1. Seleziona Esegui > Debug.

   2. Seleziona la configurazione di debug remoto.

      

      Ora puoi eseguire il debug dell'applicazione in locale.

Gradle

Configurazione del progetto utilizzando il plug-in Gradle

1. Crea un nuovo progetto Gradle.

2. Configura il debug su un server di sviluppo.

3. Crea la configurazione di esecuzione/debug per Gradle.

   

   1. Seleziona Esegui > Modifica configurazioni.

   2. Fai clic su + Aggiungi nuova configurazione.

   3. Seleziona Gradle.

   4. Nel campo Progetto Gradle, seleziona il modulo in cui hai configurato il plug-in appengine-gradle-plugin.

   5. Nel campo Tasks (Attività), inserisci appengineRun.

   6. Fai clic su OK.

4. Crea una configurazione di debug remoto.

   

   1. Seleziona Esegui > Modifica configurazioni.

   2. Fai clic su + Aggiungi nuova configurazione.

   3. Seleziona Telecomando.

   4. Assicurati che il numero di porta corrisponda a quello configurato nel plug-in Gradle App Engine. La porta 5005 è quella predefinita.

   5. Nella sezione Prima del lancio, fai clic su + Aggiungi.

   6. Seleziona Esegui un'altra configurazione.

   7. Seleziona la configurazione di esecuzione per il progetto Gradle.

   8. Fai clic su OK.

5. Per eseguire il debug dell'applicazione in locale:

   1. Seleziona Esegui > Debug.

   2. Seleziona la configurazione di debug remoto.

      

      Ora puoi eseguire il debug dell'applicazione in locale.

   3. Se nel log della console viene visualizzato il link Collega debugger, fai clic sul link.

      Nota: se la porta che hai scelto è bloccata, configura un numero di porta diverso (ad esempio 5009) nella configurazione del plug-in Gradle App Engine e aggiorna il numero di porta nella configurazione remota impostandolo sullo stesso numero.

Passaggi successivi

• Successivamente, puoi eseguire il deployment dell'app nell'ambiente standard di 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.