Esecuzione, test e deployment del backend

Puoi eseguire e testare il tuo 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:

Fai clic su Esegui > Modifica configurazioni per aprire il modulo Configurazioni di debug/esecuzione:

Tieni presente che quando aggiungi il modello di modulo di backend al progetto, viene creata una nuova configurazione di esecuzione per il backend, che ha il nome del modulo assegnato durante la creazione del backend.
Nel riquadro a sinistra, in DevAppServer di App Engine, individua il modulo di backend appena aggiunto, selezionalo e fai clic su OK.
Fai clic su Build > Rebuild Project (Crea progetto) e attendi il completamento della build.
Seleziona Esegui > Esegui <your-backend-module-name> per avviare il backend nel server di sviluppo locale di App Engine in Android Studio:

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

Vai alla pagina http://localhost:8080 sulla macchina che esegue il tuo progetto Android Studio. Se tutto è andato bene, dovresti vedere la seguente pagina:

La pagina mostrata è relativa al backend degli endpoint. 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 un po' di codice alla tua app Android, come descritto nel file README appropriato:

Dovrai anche aggiungere qualsiasi comportamento personalizzato al tuo backend.

Test del backend Endpoints utilizzando Explorer API

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

Avvia ed esegui il tuo backend localmente come descritto in precedenza.
Vai alla pagina http://localhost:8080/_ah/api/explorer sul computer che esegue il tuo progetto Android Studio. Se non ci sono problemi, dovresti vedere una pagina simile alla seguente:
Fai clic sul nome dell'API, ad esempio myApi, per visualizzare i metodi disponibili da questa API.
Fai clic su un metodo, ad esempio myApi.sayHi per visualizzare il modulo Explorer per questo metodo:
Specifica un valore per il campo di immissione se ne ha uno; utilizza il backend predefinito come esempio, fornisci il tuo nome nel campo name. Fai clic su Esegui e controlla la risposta relativa alla risposta prevista.

Deployment dei backend

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

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

Interrompi il backend, se è in esecuzione localmente, selezionando Esegui > Arresta.
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.
Nella finestra di dialogo Esegui il deployment in App Engine, seleziona il modulo. Dall'elenco a discesa Esegui il deployment in:, 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 in fondo al menu a discesa e fai clic su Fai clic qui. A questo punto, accedi alla console Google Cloud per creare il progetto. Tornando alla finestra di dialogo in Android Studio, 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 account diverso, scorri fino in fondo al menu a discesa e fai clic su Aggiungi account.
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.