Puedes ejecutar y probar tu backend de manera local y, luego, implementarlo con Android Studio.
Ejecuta y prueba el backend de manera local
Después de agregar la plantilla de backend de Endpoints, debes probarla de manera local para asegurarte de que tu entorno funcione correctamente. Para ejecutar la plantilla de backend de manera local, sigue estos pasos:
Haz clic en Ejecutar > Editar configuraciones para abrir el formato Run/Debug Configurations (Ejecutar/depurar configuraciones):
Ten en cuenta que, cuando agregas la plantilla del módulo de backend a tu proyecto, se crea una configuración de ejecución nueva para el backend. Tiene el nombre del módulo que asignaste durante la creación del backend.
En el panel izquierdo, en App Engine DevAppServer, busca el módulo de backend que acabas de agregar, selecciónalo y haz clic en Aceptar.
Haz clic en Compilar > Volver a compilar proyecto y espera a que finalice la compilación.
Selecciona Ejecutar > Ejecutar
<your-backend-module-name>
para iniciar el backend en el servidor de desarrollo local de App Engine en Android Studio:Espera a que el backend se inicie en el servidor de desarrollo. Cuando termine de cargarse, se mostrará un mensaje como el siguiente en la consola:
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
Ve a http://localhost:8080 en la máquina que ejecuta tu proyecto de Android Studio. Si todo sale bien, debes ver la siguiente página:
(La página que se muestra es del backend de Endpoints. La página de los otros tipos de backend será un poco diferente).
Observa los vínculos en la parte superior de la página, especialmente el vínculo que te lleva a la consola de Google Cloud, en la que puedes crear o configurar un proyecto. Se necesitará un proyecto para implementar tu backend una vez finalizado tu trabajo de desarrollo y prueba.
En este punto, el backend predeterminado de la plantilla se ejecuta correctamente. Sin embargo, tu app para Android aún no está conectada al backend. Si quieres acceder a él, deberás agregar un código a tu app para Android, como se describe en el archivo README correspondiente:
- Módulo de Servlet de Java en App Engine
- Módulo de Endpoints de Java en App Engine
- Backend de App Engine con Google Cloud Messaging
También deberás agregar cualquier comportamiento personalizado que desees que tu backend tenga.
Prueba el backend de Endpoints con el Explorador de API
En los backends con Endpoints, puedes probar el funcionamiento de la API directamente con el Explorador de API de Google integrado:
Inicia y ejecuta tu backend de manera local como se describe anteriormente.
Ve a http://localhost:8080/_ah/api/explorer en la máquina que ejecuta tu proyecto de Android Studio. Si todo sale bien, debes ver una página como la que se muestra a continuación:
Haz clic en el nombre de la API, por ejemplo, myApi API (API de myApi), para mostrar los métodos disponibles de esta API.
Haz clic en un método, por ejemplo, myApi.sayHi para mostrar el formulario del explorador de este método:
Proporciona un valor para el campo de entrada si tiene uno, con el backend predeterminado como ejemplo y proporciona tu nombre en el campo name (nombre). Haz clic en Execute (Ejecutar) y marca la respuesta para la respuesta esperada.
Implementa backends
Si tu backend funciona de manera local, puedes implementarlo en Google App Engine.
Antes de implementar tu backend, debes crear un proyecto de Cloud para ese backend y agregarle el ID del proyecto, como se describe en el archivo README de tu plantilla de backend (Módulo de Servlet/Módulo de extremos/Backend con Google Cloud Messaging). Para implementarlo en App Engine desde Android Studio, realiza sigue estos pasos:
Selecciona Ejecutar > Detener para detener el backend si se ejecuta de manera local.
Ejecuta Compilar > Implementar módulo en App Engine.
- Si ejecutas esta tarea por primera vez, se te solicitará que accedas con tu Cuenta de Google. Selecciona una cuenta y accede.
En el cuadro de diálogo Deploy to App Engine (Implementar en App Engine), selecciona tu módulo. En la lista desplegable Implementar en:, elige un proyecto de la consola de Google Cloud (en este ejemplo,
backend-example-352
).Desplázate hasta la parte inferior de la lista desplegable si necesitas crear un proyecto nuevo o acceder con una cuenta diferente:
- Para crear un proyecto nuevo, desplázate hasta la parte inferior de la lista desplegable y haz clic en Click Here (Hacer clic aquí). Esto te llevará a la consola de Google Cloud para crear el proyecto. En el cuadro de diálogo Android Studio, haz clic en el botón Actualizar para incluir tu proyecto nuevo en la lista desplegable. Selecciona el proyecto nuevo.
- Si deseas crear una cuenta nueva o especificar una cuenta existente diferente, desplázate hasta la parte inferior de la lista desplegable y haz clic en Add Account (Agregar cuenta).
En el cuadro de diálogo Deploy to App Engine (Implementar en App Engine), haz clic en Deploy (Implementar). Puedes supervisar el estado de tu implementación en la consola de Android Studio.