Ejecuta, implementa y prueba el backend

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:

  1. Haz clic en Ejecutar > Editar configuraciones para abrir el formato Run/Debug Configurations (Ejecutar/depurar configuraciones):

    Ejecuta configuración de backend

    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.

  2. 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.

  3. Haz clic en Compilar > Volver a compilar proyecto y espera a que finalice la compilación.

  4. Selecciona Ejecutar > Ejecutar <your-backend-module-name> para iniciar el backend en el servidor de desarrollo local de App Engine en Android Studio:

    Ejecuta configuración de backend

  5. 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
    
  6. 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:

    Backend de "HelloWorld" que se ejecuta de manera local

    (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 que aparecen en la parte superior de la página, especialmente el que te lleva a Google Cloud Console, en el 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:

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:

  1. Inicia y ejecuta tu backend de manera local como se describe anteriormente.

  2. 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:

    Explorador de API de Cloud Endpoints

  3. Haz clic en el nombre de la API, por ejemplo, myApi API (API de myApi), para mostrar los métodos disponibles de esta API.

  4. Haz clic en un método, por ejemplo, myApi.sayHi para mostrar el formulario del explorador de este método:

    Formulario SayHi

  5. 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:

  1. Selecciona Ejecutar > Detener para detener el backend si se ejecuta de manera local.

  2. 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.
  3. En el cuadro de diálogo Deploy to App Engine (Implementar en App Engine), selecciona tu módulo. En la lista desplegable Deploy To: (Implementar en:), selecciona un proyecto de consola (en este ejemplo, backend-example-352).

    Implementa App Engine

    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í). Esta acción te llevará a la consola 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).

    Agrega cuenta

  4. 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.