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

Generar la biblioteca de cliente

En las siguientes instrucciones se muestra cómo usar los complementos Apache Maven y Gradle de Cloud Endpoints Frameworks para generar un paquete de cliente de Gradle a partir del proyecto Maven de ejemplo Primeros pasos con Endpoints.

Para generar una biblioteca de cliente, sigue estos pasos:

  1. Crear una API

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

    Maven

    mvn endpoints-framework:clientLibs

    Gradle

    gradle endpointsClientLibs

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

    Maven

    API client library written to target/client-libs/echo-v1-java.zip

    Gradle

    API client library written to build/endpointsClientLibs/echo-v1-java.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:

    Maven

    mvn clean package

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

    Gradle

    gradle build

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

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

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

Siguientes pasos