Nota: Java 8 ha raggiunto la fine del supporto il 31 gennaio 2024. Le applicazioni Java 8 esistenti continueranno a essere eseguite e a ricevere traffico. Tuttavia, App Engine potrebbe bloccare il ri deployment di applicazioni che utilizzano runtime dopo la data di fine del supporto. Ti consigliamo di eseguire la migrazione alla versione più recente supportata di Java.

Attività e proprietà del plug-in Gradle per App Engine

Dopo aver aggiunto il plug-in di App Engine al progetto, puoi utilizzare le seguenti attività Gradle specifiche di App Engine per le applicazioni nell'ambiente standard di App Engine:

Attività	Descrizione
`tasks`	Visualizza le informazioni della guida sulle attività installate.
`appengineCloudSdkLogin`	Imposta lo stato globale dellgcloud CLI per account.
`appengineDeploy`	Esegue temporaneamente ed esegue il deployment di un'applicazione in App Engine.
`appengineDeployAll`	Esegue contemporaneamente ed esegue il deployment di un'applicazione con tutte le sue configurazioni YAML valide contemporaneamente su App Engine.
`appengineDeployCron`	Esegue le fasi ed esegue il deployment di un file di configurazione `cron.yaml` in App Engine.
`appengineDeployDispatch`	Esegue le fasi ed esegue il deployment di un file di configurazione `dispatch.yaml` in App Engine.
`appengineDeployDos`	Esegue le fasi ed esegue il deployment di un file di configurazione `dos.yaml` in App Engine.
`appengineDeployIndex`	Esegue le fasi ed esegue il deployment di un file di configurazione `index.yaml` in App Engine.
`appengineDeployQueue`	Esegue le fasi ed esegue il deployment di un file di configurazione `queue.yaml` in App Engine.
`appengineRun`	Esegue il server di sviluppo di App Engine. Quando il server è in esecuzione, controlla continuamente per determinare se `appengine-web.xml` è stato modificato. In questo caso, il server ricarica l'applicazione. Non è necessario arrestare e riavviare l'applicazione a causa delle modifiche a `appengine-web.xml`.
`appengineStage`	Genera una directory dell'applicazione per il deployment.
`appengineStart`	Avvia l'esecuzione del server di sviluppo App Engine in modo asincrono, quindi torna alla riga di comando. Quando questo obiettivo viene eseguito, il comportamento è uguale a quello dell'obiettivo di esecuzione, ma Gradle continua le attività di elaborazione e si chiude dopo che il server è attivo e in esecuzione.
`appengineStop`	Interrompe un server di sviluppo web di App Engine in esecuzione.
`explodeWar`	Fai esplodere il file WAR nella directory di compilazione.

Per vedere un elenco di tutte le attività:

gradle tasks

Per ulteriori informazioni su come configurare e utilizzare Gradle, consulta Utilizzo di App Engine Gradle.

Proprietà attività

I contenuti del file gradle.build sono un insieme di regole che descrivono la tua build. È scritto in un linguaggio specifico del dominio per descrivere le build, sulla base del linguaggio Groovy.

A ogni attività sono associate delle proprietà che puoi utilizzare. Puoi specificare queste proprietà nel file gradle.build utilizzando un'attività di chiusura della configurazione e le proprietà.

Nell'esempio seguente:

La chiusura della configurazione del plug-in è appengine.
L'attività è run.
La proprietà port è impostata su 8080.

appengine {  // App Engine tasks configuration
  run {      // local (dev_appserver) configuration (standard environments only)
    port = 8080                 // default
  }

  deploy {   // deploy configuration
    stopPreviousVersion = true  // default - stop the current version
    promote = true              // default - & make this the current version
  }
}

Se devi specificare solo alcune proprietà, puoi impostarle su un'unica riga:

  appengine.run.port = 8888

Consulta le sezioni seguenti per un elenco delle proprietà disponibili per ogni attività.

appengineStage

attività(fase)

Genera una directory dell'applicazione per il deployment. appengineStage è utilizzato dall'attività appengineDeploy.

Puoi utilizzare le seguenti proprietà:

Proprietà	Descrizione
`compileEncoding`	La codifica dei caratteri da utilizzare durante la compilazione di JSP. Si applica solo alle applicazioni in esecuzione nell'ambiente standard di App Engine.
`deleteJsps`	Elimina i file di origine JSP dopo la compilazione. Si applica solo alle applicazioni in esecuzione nell'ambiente standard di App Engine.
`disableJarJsps`	Disabilita l'aggiunta delle classi generate dai JSP. Si applica solo alle applicazioni in esecuzione nell'ambiente standard di App Engine.
`disableUpdateCheck`	Disabilita la verifica degli aggiornamenti gcloud CLI.
`enableJarClasses`	Barattolo su `WEB-INF/classes content`. Si applica solo alle applicazioni in esecuzione nell'ambiente standard di App Engine.
`useMtimeFileWatcher`	Utilizza il polling Mtime per rilevare le modifiche al codice sorgente. Utile in caso di modifica del codice da una macchina remota che utilizza un file system distribuito.
`enableJarSplitting`	Suddividi i file JAR di dimensioni superiori a 10 MB in frammenti più piccoli. Si applica solo all'ambiente standard di App Engine.
`enableQuickstart`	Utilizza la guida rapida di Eclipse Jetty per elaborare le annotazioni servlet. Si applica solo all'ambiente standard di App Engine.
`jarSplittingExcludes`	Escludi i file che corrispondono all'elenco di valori Calcolati da virgole separati da tutti i file JAR. Si applica solo alle applicazioni in esecuzione nell'ambiente standard di App Engine.
`sourceDirectory`	obbligatorio. La posizione dei file dell'applicazione web compilati o l'esplosione di WAR. utilizzata come origine per la gestione temporanea. Si applica solo all'ambiente standard di App Engine. Il valore predefinito è `build/exploded-${gradle-module-name}`.
`stagingDirectory`	obbligatorio. La directory in cui posizionare l'applicazione. Il valore predefinito è `build/staged-app`.

appengineRun

task(esecuzione)

Esegue il server web di sviluppo di App Engine. Quando il server è in esecuzione, controlla continuamente per determinare se appengine-web.xml è cambiato. In questo caso, il server ricarica l'applicazione. Ciò significa che non è necessario arrestare e riavviare l'applicazione a causa delle modifiche a appengine-web.xml.

Puoi utilizzare le seguenti proprietà, alcune delle quali corrispondono ai flag della riga di comando del server di sviluppo locale:

Proprietà	Descrizione
`environment`	Una mappa delle variabili di ambiente da inviare al server di sviluppo locale. Esempio: `[key1: "value1", key2: "value2"]`
`jvmFlags`	Argomenti aggiuntivi da passare al comando Java durante l'avvio di un'istanza dell'app. Possono essere specificati più di una volta. Esempio: `-Xmx1024m -Xms256m`
`host`	Nome host a cui devono essere associati i servizi dell'applicazione. Il valore predefinito è `localhost`.
`port`	Porta più bassa a cui devono essere associati i servizi delle applicazioni. Il valore predefinito è `8080`.
`serverVersion`	Versione server da lanciare, le opzioni sono "1" e "2-alpha". Il valore predefinito è "1".
`services`	obbligatorio. Percorsi di una directory contenente una directory contenente `WEB-INF/web.xml`. Il valore predefinito è `build/exploded-app`.
`startSuccessTimeout`	Tempo di attesa in secondi per l'avvio del server di app Dev in background (quando si utilizza appengineStart).

appengineDeploy

task(deploy)

Esegue temporaneamente ed esegue il deployment di un'applicazione in App Engine.

Proprietà	Descrizione
`appEngineDirectory`	Percorso dei file di configurazione `.yaml` (cron, index e così via) da cui verrà eseguito il deployment dei deployment specifici della configurazione (appengineDeployCron e così via). Per le applicazioni standard, i file di configurazione `.xml` vengono convertiti durante la gestione temporanea in `.yaml` e posizionati in `build/staged-app/WEB-INF/appengine-generated`.
`bucket`	Il bucket Google Cloud Storage utilizzato per posizionare temporaneamente i file associati al deployment. Se questo argomento non viene specificato, viene utilizzato il bucket predefinito dell'applicazione.
`imageUrl`	Eseguire il deployment con un'immagine Docker specifica. L'URL Docker deve provenire da uno dei nomi host di Google Container Registry validi.
`projectId`	L'ID progetto della piattaforma Google Cloud da utilizzare per questa chiamata. Devi specificare un projectId oppure puoi impostare `GCLOUD_CONFIG` in modo che utilizzi il set di progetti nello stato di configurazione di gcloud.
`promote`	Promuovi la versione di cui è stato eseguito il deployment in modo da ricevere tutto il traffico. Il valore predefinito è True.
`server`	Il server App Engine a cui connettersi. In genere, non è necessario modificare questo valore.
`stopPreviousVersion`	Arresta la versione in esecuzione in precedenza quando esegui il deployment di una nuova versione che riceve tutto il traffico.
`version`	La versione dell'app che verrà creata o sostituita da questo deployment. Se non specifichi una versione, ne verrà generata una automaticamente.

Proprietà globali

Proprietà	Descrizione
`tools.cloudSdkHome`	Proprietà facoltativa per configurare la posizione di gcloud CLI. Se questa proprietà non è specificata, il plug-in scarica automaticamente gcloud CLI.
`tools.cloudSdkVersion`	Parametro facoltativo per specificare la versione gcloud CLI desiderata.