Generar una biblioteca de cliente

En esta página se describe cómo generar una biblioteca de cliente a partir de tu API de backend de Python (el código que se ejecuta en el servidor). Cualquier aplicación Java o Android puede usar esta biblioteca para llamar a la API.

Para crear clientes iOS para tu API, te recomendamos que uses la biblioteca de cliente de APIs de Google para Objective-C para APIs REST.

Antes de empezar

  • Descarga la biblioteca y las herramientas de Cloud Endpoints Frameworks en el directorio de tu aplicación, tal como se describe en la sección Empezar a usar Endpoints Frameworks.
  • Asegúrate de haber decorado correctamente el código de tu API con el código de los frameworks esperados.

Generar la biblioteca de cliente

En las siguientes instrucciones se muestra cómo usar la herramienta de línea de comandos de Endpoints Frameworks para generar un paquete de cliente de Gradle a partir del código de ejemplo de Empezar a usar Cloud Endpoints.

Para generar una biblioteca de cliente, sigue estos pasos:

  1. Cambia el directorio por el que contiene el archivo app.yaml de la API y las clases de la API.

  2. Ejecuta la herramienta de línea de comandos de Endpoints de forma similar a la siguiente:

    python lib/endpoints/endpointscfg.py get_client_lib java -bs gradle main.EchoApi

    donde main es la clase que contiene tu API y EchoApi es el nombre de tu API.

    Espera a que la herramienta genere la biblioteca. Si se completa correctamente, la herramienta mostrará un mensaje similar a este:

    API client library written to ./echo-v1.zip

  3. Descomprime el archivo con la utilidad de descompresión u otra utilidad de descompresión compatible con ZIP:

    unzip ./echo-v1-java.zip

  4. Cambiar de directorio:

    cd echo

  5. Crea la biblioteca de cliente:

    gradle build

    El resultado se encuentra en el directorio build/libs. El nombre de archivo exacto depende de la versión del cliente. Es similar a echo-v1-1.23.0-SNAPSHOT.jar.

  6. Añade el archivo JAR de la biblioteca de cliente a tu aplicación.

  7. Repite estos pasos cada vez que modifiques el código de la API.

Siguientes pasos

Para obtener información y ejemplos de código que muestran cómo acceder a una API de backend desde un cliente de Python, consulta Acceder a APIs de backend desde clientes de Python.