Esegui e esegui il debug di un'app App Engine Standard localmente in Cloud Code for IntelliJ

Attenzione: 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 disabilita App Engine per impostazione predefinita. Per attivare App Engine nel tuo IDE, vai a Impostazioni > Google Cloud Code > App Engine. A causa dell'imminente ritiro di App Engine, non consigliamo di creare nuovi progetti App Engine. Per ulteriori informazioni sui ritiri di App Engine, consulta Funzionalità deprecate. Per ulteriori informazioni sul programma di supporto del runtime per App Engine, consulta Programma di supporto del runtime.

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

Nota:i seguenti IDE supportano questa funzionalità:

• IntelliJ IDEA - Ultimate
• IntelliJ IDEA - Community

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

Prima di iniziare

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

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

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

Esecuzione dell'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 di sviluppo App Engine Standard locale.

La creazione del progetto richiede un attimo.

Modifica della configurazione di esecuzione

Configurare 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 in base alle esigenze. Alcune impostazioni comuni includono:

   • Artefatto di cui eseguire il deployment.
   • Host App Engine.
   • Porta App Engine.

Aggiungere 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 variabili di ambiente.

4. Aggiungi le variabili necessarie.

5. Seleziona Debug.

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

7. Aggiungi le variabili necessarie.

   

8. Al termine, fai clic su Ok.

Arresto del server

Per arrestare il server di sviluppo dell'app, scegli Esegui > Arresta "Google App Engine Standard Local Server".

Debug dell'applicazione

Puoi utilizzare la configurazione di esecuzione creata in precedenza per eseguire l'applicazione in modalità di debug nel seguente modo:

1. Seleziona Esegui > Debug.

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

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

Esecuzione del debug dell'applicazione in locale su Community Edition

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

Maven

Configurazione del progetto utilizzando il plug-in Maven

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

2. Configura il debug su un server di sviluppo.

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

   

   1. Seleziona Esegui > Modifica configurazioni.

   2. Fai clic su + Aggiungi nuova configurazione.

   3. Seleziona Maven.

   4. Nel campo Riga 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 sia lo stesso di quello configurato nella configurazione del plug-in Maven App Engine. La porta 5005 è il valore predefinito.

   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 della tua 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 una 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 sia lo stesso di quello configurato nella configurazione del 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 della tua 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 con lo stesso numero di porta.

Passaggi successivi

• Dopodiché, puoi eseguire il deployment dell'app nell'ambiente standard di App Engine.

Assistenza

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