Genera una biblioteca cliente

En esta página, se describe cómo generar una biblioteca cliente desde tu API de backend de Python (el código que se ejecuta en el servidor). Todas las apps para Java o Android pueden usar esta biblioteca a fin de llamar a la API.

A fin de crear clientes iOS para tu API, te recomendamos usar la Biblioteca Cliente Objetivo-C de las API de Google para las API de REST

Para las aplicaciones de JavaScript, consulta Enviar una solicitud autenticada desde JavaScript.

Antes de comenzar

  • Descarga la biblioteca y las herramientas de Cloud Endpoints Frameworks en el directorio de tu aplicación como se describe en Comenzar a usar Endpoints Frameworks.
  • Asegúrate de haber decorado correctamente tu código API con el código de Frameworks esperado.

Generar la biblioteca cliente

Las siguientes instrucciones muestran cómo usar la herramienta de línea de comandos de Frameworks para generar un paquete de cliente Gradle a partir del código de muestra de Comenzar a usar Cloud○Endpoints.

Para generar una biblioteca cliente:

  1. Cambia a un directorio que contenga tu archivo API app.yaml y clases de API.

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

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

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

    Espera a que la herramienta genere la biblioteca; cuando lo logre, la herramienta mostrará un mensaje como este:

    API client library written to ./echo-v1.zip
    
  3. Descomprime el archivo con la utilidad de descompresión, o usa otra utilidad de extracción compatible con ZIP:

    unzip ./echo-v1-java.zip
    
  4. Cambia el directorio:

    cd echo
    
  5. Compila la biblioteca cliente:

    gradle build
    

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

  6. Agrega el JAR de la biblioteca cliente a tu app.

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

Qué sigue

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