Exécuter, tester et déployer le backend

Vous pouvez exécuter et tester votre backend localement, et le déployer à l'aide d'Android Studio.

Exécuter et tester le backend localement

Après avoir ajouté le modèle de backend Endpoints, vous devez le tester localement pour vous assurer que votre environnement fonctionne correctement. Pour exécuter le modèle de backend localement :

1. Cliquez sur Run > Edit Configurations (Exécuter > Modifier les configurations) pour ouvrir le formulaire Run/Debug Configurations (Configurations d'exécution/de débogage) :

   

   Notez que lorsque vous ajoutez le modèle de module backend à votre projet, une configuration d'exécution est créée pour le backend. Elle porte le nom de module que vous avez attribué lors de la création du backend.

2. Dans le volet de gauche, sous App Engine DevAppServer, localisez le module backend que vous venez d'ajouter, sélectionnez-le et cliquez sur "OK".

3. Cliquez sur Build > Rebuild Project (Compiler > Recompiler le projet) et attendez la fin de la compilation.

4. Sélectionnez Run > Run <your-backend-module-name> (Exécuter > Exécuter <nom de votre module backend>) pour lancer le backend sur le serveur de développement App Engine local dans Android Studio :

   

5. Attendez que le backend démarre sur le serveur de développement ; une fois le chargement terminé, un message semblable au suivant s’affiche dans la console :

       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. Accédez à http://localhost:8080 sur la machine exécutant votre projet Android Studio. Si tout s'est bien passé, la page suivante doit normalement s'afficher :

   

   (La page affichée concerne le backend Endpoints. Elle sera légèrement différente pour les autres types de backend.)

   Notez les liens en haut de la page, en particulier celui qui vous redirige vers la console Google Cloud, où vous pouvez créer ou configurer un projet. Vous aurez besoin d'un projet pour déployer votre serveur une fois vos tâches de développement et de test terminées.

À ce stade, le backend par défaut du modèle s'exécute correctement. Cependant, votre application Android n'est pas encore connectée au backend. Pour accéder au backend, vous devez ajouter du code à votre application Android, comme décrit dans le fichier README approprié :

• Module Servlet Java pour App Engine
• Module Endpoints Java pour App Engine
• Backend App Engine avec Google Cloud Messaging

Vous devrez également ajouter le comportement personnalisé souhaité pour votre backend.

Tester le backend Endpoints à l'aide de l'explorateur d'API

Pour les backends Endpoints, vous pouvez tester le fonctionnement de l'API directement à l'aide de l'explorateur d'API Google intégré :

1. Démarrez et exécutez votre backend localement comme décrit précédemment.

2. Accédez à http://localhost:8080/_ah/api/explorer sur la machine exécutant votre projet Android Studio. Si tout s'est bien passé, la page suivante doit normalement s'afficher :

   

3. Cliquez sur le nom de l'API, par exemple myApi API, pour afficher les méthodes disponibles à partir de cette API.

4. Cliquez sur une méthode, par exemple myApi.sayHi pour afficher le formulaire de l'explorateur pour cette méthode :

   

5. Entrez une valeur dans le champ de saisie le cas échéant. Si l'on prend le backend par défaut comme exemple, renseignez votre nom dans le champ name (nom). Cliquez sur Execute (Exécuter) et vérifiez la réponse attendue dans la section Response.

Déployer des backends

Si votre backend fonctionne localement, vous pouvez le déployer dans Google App Engine.

Avant de déployer votre backend, vous devez créer un projet Cloud pour celui-ci et ajouter l'ID de projet à votre backend, comme décrit dans le fichier README du modèle de votre backend (Module Servlet/Module Endpoints/Backend avec Google Cloud Messaging). Pour déployer votre backend dans App Engine depuis Android Studio :

1. Si le backend est en cours d'exécution localement, arrêtez-le en sélectionnant Run > Stop (Exécuter > Arrêter).

2. Exécutez Build > Deploy Module to App Engine (Compiler > Déployer le module dans App Engine).

   • Si vous exécutez cette tâche pour la première fois, vous serez invité à vous connecter avec votre compte Google. Choisissez un compte et connectez-vous.

3. Dans la boîte de dialogue Deploy to App Engine (Déployer dans App Engine), sélectionnez votre module. Dans la liste déroulante Déployer dans:, choisissez un projet de la console Google Cloud (dans cet exemple, backend-example-352).

   

   Faites défiler la liste déroulante jusqu'en bas si vous devez créer un projet ou vous connecter avec un autre compte :

   • Pour créer un projet, faites défiler la liste déroulante jusqu'en bas et cliquez sur Click Here (Cliquez ici). Vous êtes alors redirigé vers la console Google Cloud pour créer le projet. Revenez dans la boîte de dialogue dans Android Studio et cliquez sur le bouton d'actualisation pour inclure votre nouveau projet dans la liste déroulante. Sélectionnez ensuite le nouveau projet.
   • Si vous souhaitez créer un compte ou spécifier un autre compte existant, faites défiler la liste déroulante jusqu'en bas et cliquez sur Add Account (Ajouter un compte).

   

4. Revenez dans la boîte de dialogue Deploy to App Engine (Déployer dans App Engine) puis cliquez sur Deploy (Déployer). Vous pouvez surveiller l'état de votre déploiement dans la console Android Studio.