Generazione di una libreria client

Questa pagina descrive come generare una libreria client dall'API di backend. Qualsiasi app Java o Android può utilizzare questa libreria per chiamare l'API.

Per creare client iOS per la tua API, ti consigliamo di utilizzare la libreria client per le API di Google in Objective-C per le API REST.

Prima di iniziare

Generazione della libreria client

Le istruzioni riportate di seguito mostrano come utilizzare i plug-in Apache Maven e Gradle per i framework Cloud Endpoints per generare un bundle client Gradle dal progetto Maven di esempio Introduzione a Endpoints.

Per generare una libreria client:

  1. Creare l'API

  2. Esegui lo strumento a riga di comando Endpoints Frameworks in modo simile a quanto segue:

    Maven

    mvn endpoints-framework:clientLibs

    Gradle

    gradle endpointsClientLibs

    Attendi che lo strumento generi la libreria. Se l'operazione è andata a buon fine, viene visualizzato un messaggio simile al seguente:

    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. Estrai il file utilizzando l'utilità unzip o un'altra utility di estrazione supportata da ZIP:

    unzip ./echo-v1-java.zip

  4. Cambia directory:

    cd echo

  5. Compila la libreria client:

    Maven

    mvn clean package

    L'output si trova nella directory target/. Il nome file esatto dipende dalla versione del client Java. È simile a echo-v1-1.23.0-SNAPSHOT.jar.

    Gradle

    gradle build

    L'output si trova nella directory build/libs. Il nome file esatto dipende dalla versione del client Java. È simile a echo-v1-1.23.0-SNAPSHOT.jar.

  6. Aggiungi il file JAR della libreria client alla tua app Java o Android.

  7. Ripeti questi passaggi ogni volta che modifichi il codice API.

Passaggi successivi