Esecuzione, test e deployment del backend

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

Esecuzione e test del backend in locale

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

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

   

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

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

3. Fai clic su Build > Rebuild Project (Crea progetto) e attendi il completamento della build.

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

   

5. Attendi l'avvio del backend nel server di sviluppo; al termine del caricamento, nella console verrà 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 a http://localhost:8080 sul computer che esegue il tuo progetto Android Studio. Se tutto è andato bene, dovresti vedere la seguente pagina:

   

   La pagina mostrata è relativa al backend Endpoints. La pagina per gli altri tipi di backend sarà leggermente diversa.)

   Osserva i link nella parte superiore della pagina, in particolare il link che porta alla console Google Cloud, in cui puoi creare o configurare un progetto. Avrai bisogno di un progetto per eseguire il deployment del backend al termine del lavoro 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 alla tua app Android come descritto nel file README appropriato:

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

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

Test del backend Endpoints utilizzando Explorer API

Per i backend con endpoint, puoi testare il funzionamento dell'API direttamente tramite l'Explorer API integrato di Google:

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

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

   

3. Fai clic sul nome dell'API, ad esempio myApi API, 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. Specifica un valore per il campo di input, se presente. Utilizza il backend predefinito come esempio e fornisci il tuo nome nel campo name. Fai clic su Esegui e controlla la risposta desiderata.

Deployment dei backend

Se il tuo backend funziona localmente, puoi eseguirne il deployment su 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 tuo modello di backend (Servlet Module/ Endpoint Module/ Backend with Google Cloud Messaging) Per eseguire il deployment del tuo backend in App Engine da Android Studio:

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

2. Esegui Build > Esegui il deployment del modulo in 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 Deploy to:, scegli un progetto per la console Google Cloud (in questo esempio backend-example-352).

   

   Scorri fino alla fine dell'elenco a discesa se devi creare un nuovo progetto o accedere con un altro account:

   • Per creare un nuovo progetto, scorri fino in fondo al menu a discesa e fai clic su Fai clic qui. Viene visualizzata la console Google Cloud per creare il progetto. Torna nella finestra di dialogo in 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 specificarne un altro esistente, scorri fino in fondo al 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 del deployment nella console di Android Studio.