Esecuzione, test e deployment del backend

Puoi eseguire e testare il tuo backend in locale ed eseguirne il deployment tramite Android Studio.

Esecuzione e test del backend in locale

Dopo aver aggiunto il modello di backend di Endpoints, devi testarlo localmente per assicurarti che l'ambiente funzioni correttamente. Per eseguire il modello di backend in locale:

1. Fai clic su Esegui > Modifica configurazioni per aprire il modulo Esegui/configurazioni di debug:

   

   Tieni presente che quando aggiungi il modello del modulo di backend al tuo progetto, viene creata una nuova configurazione di esecuzione per il backend, con il nome del modulo che hai assegnato durante la creazione del backend.

2. Nel riquadro a sinistra, in DevAppServer di App Engine, individua il modulo di backend che hai appena aggiunto, selezionalo e fai clic su OK.

3. Fai clic su Crea > Ricrea il progetto e attendi il completamento della build.

4. Seleziona Esegui > Esegui <your-backend-module-name> per avviare il backend nel server di sviluppo App Engine locale in Android Studio:

   

5. Attendi l'avvio del backend nel server di sviluppo; al termine del caricamento, nella console viene visualizzato un messaggio simile al seguente:

       Jun 18, 2014 4:07:30 PM com.google.appengine.tools.development.AbstractModule startup
       INFO: The admin console is running at http://localhost:8080/_ah/admin
       Jun 18, 2014 4:07:30 PM com.google.appengine.tools.development.DevAppServerImpl doStart
       INFO: Dev App Server is now running
   

6. Vai all'indirizzo http://localhost:8080 sulla macchina che esegue il tuo progetto Android Studio. Se è tutto a posto, dovresti visualizzare la seguente pagina:

   

   La pagina mostrata riguarda il backend di Endpoints. La pagina per gli altri tipi di backend sarà leggermente diversa.

   Osserva i link nella parte superiore della pagina, in particolare quello che rimanda alla console Google Cloud, dove puoi creare o configurare un progetto. Avrai bisogno di un progetto per eseguire il deployment del backend al termine delle attività di sviluppo e test.

A questo punto, il backend predefinito del modello è in esecuzione. Tuttavia, la tua app Android non è ancora connessa al backend. Per accedere al backend, devi aggiungere del codice per la tua app Android come descritto nel file README appropriato:

• Modulo Java Servlet di App Engine
• Modulo Java Endpoints di App Engine
• Backend di App Engine con Google Cloud Messaging

Dovrai inoltre aggiungere qualsiasi comportamento personalizzato che vuoi che abbia il backend.

Test del backend di Endpoints utilizzando Explorer API

Per i backend che hanno Endpoints, puoi testare il funzionamento dell'API direttamente utilizzando Explorer API di Google integrato:

1. Avvia ed esegui il backend in locale come descritto in precedenza.

2. Vai a http://localhost:8080/_ah/api/explorer sulla macchina che esegue il tuo progetto Android Studio. Se è tutto a posto, dovresti visualizzare una pagina simile alla seguente:

   

3. Fai clic sul nome dell'API, ad esempio API myApi per visualizzare i metodi disponibili da questa API.

4. Fai clic su un metodo, ad esempio myApi.sayHi per visualizzare il modulo Explorer per questo metodo:

   

5. Fornisci un valore per il campo di immissione, se presente. Utilizzando il backend predefinito come esempio, fornisci il tuo nome nel campo name. Fai clic su Esegui e controlla che nella risposta sia presente la risposta prevista.

Deployment dei backend

Se il tuo backend funziona in locale, puoi eseguirne il deployment in Google App Engine.

Prima di eseguire il deployment del backend, devi creare un progetto Cloud e aggiungere l'ID progetto al backend, come descritto nel file README per il modello di backend (Modulo Servlet/Modulo endpoint/Backend con Google Cloud Messaging) Per eseguire il deployment del backend in App Engine da Android Studio:

1. Arresta il backend, se è in esecuzione in locale, selezionando Esegui > Arresta.

2. Esegui Build > Deploy Module to App Engine.

   • Se stai eseguendo questa attività per la prima volta, ti verrà chiesto di accedere con il tuo Account Google. Scegli un account e accedi.

3. Nella finestra di dialogo Esegui il deployment in App Engine, seleziona il modulo. Dall'elenco a discesa Esegui il deployment a:, scegli un progetto della console Google Cloud (in questo esempio, backend-example-352).

   

   Scorri fino in fondo all'elenco a discesa se devi creare un nuovo progetto o accedere con un altro account:

   • Per creare un nuovo progetto, scorri fino alla fine del menu a discesa e fai clic su Fai clic qui. Accederai alla console Google Cloud per creare il progetto. Torna alla finestra di dialogo di Android Studio e fai clic sul pulsante Aggiorna per includere il nuovo progetto nel menu a discesa. Seleziona il nuovo progetto.
   • Se vuoi creare un nuovo account o specificare un altro account esistente, scorri fino alla fine del menu a discesa e fai clic su Aggiungi account.

   

4. Torna alla finestra di dialogo Esegui il deployment in App Engine, fai clic su Esegui il deployment. Puoi monitorare lo stato dell'implementazione nella console di Android Studio.