Esecuzione e debug in locale di un'app App Engine Standard in Cloud Code for IntelliJ

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

Nota: i seguenti IDE supportano questa funzionalità:

• IDEA IntelliJ - Ultimate
• IDEA IntelliJ - 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 l'applicazione sia un progetto standard App Engine che contiene un file appengine-web.xml

• Per accedere alle librerie client di Cloud in locale, completa le procedure Aggiunta delle librerie client di Cloud ai tuoi progetti Maven.

Nota: le configurazioni di esecuzione per l'esecuzione locale e il debug sono disponibili solo in IntelliJ Ultimate Edition. Se usi Community Edition, puoi seguire le istruzioni per il debug della tua applicazione in locale 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 da 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 alcuni istanti.

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 Esegui/configurazioni debug, aggiorna le impostazioni di configurazione in base alle esigenze. Alcune impostazioni comuni sono:

   • Artefatto di cui eseguire il deployment.
   • dell'host App Engine.
   • Porta App Engine.

Aggiungi variabili di ambiente

Se necessario, aggiungi variabili di ambiente alla configurazione.

1. Seleziona la scheda Startup/Connection (Avvio/Connessione).

2. Seleziona Esegui.

3. Seleziona la casella di controllo Pass variabili di ambiente.

4. Aggiungi le variabili necessarie.

5. Seleziona Debug.

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

7. Aggiungi le variabili necessarie.

   

8. Al termine, fai clic su OK.

Arresto del server

Per arrestare il server di sviluppo di app, scegli Esegui > Interrompi "Server locale standard di Google App Engine".

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 Server locale standard di Google App Engine.

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

Debug dell'applicazione in locale su Community Edition

IntelliJ Community Edition non offre supporto integrato per l'esecuzione di applicazioni Java locali basate su servlet. Per eseguire il debug della tua applicazione in locale con IntelliJ Community Edition, configura il tuo progetto in modo da utilizzare il plug-in Maven o Gradle.

Maven

Configurazione del progetto mediante il plug-in Maven

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

2. Configura il debug su un server di sviluppo.

3. Creare 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 Riga di comando, inserisci appengine:run.

   5. Fai clic su Ok.

4. Crea una configurazione di debug remota.

   

   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 della porta configurata nella configurazione del plug-in Maven App Engine. La porta 5005 è la porta 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 della tua applicazione in locale:

   1. Seleziona Esegui > Debug.

   2. Seleziona la configurazione del 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. Creare 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, inserisci appengineRun.

   6. Fai clic su Ok.

4. Crea una configurazione di debug remota.

   

   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 della porta configurata nella configurazione del plug-in Gradle App Engine. La porta 5005 è la porta 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 della tua applicazione in locale:

   1. Seleziona Esegui > Debug.

   2. Seleziona la configurazione del debug remoto.

      

      Ora puoi eseguire il debug della tua applicazione in locale.

   3. Se nel log della console viene visualizzato il link Attach 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 della tua app nell'ambiente standard 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.