Generazione di una libreria client

Questa pagina descrive come generare una libreria client dall'API backend Python (il codice in esecuzione sul server). 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 Objective-C delle API di Google per le API REST.

Prima di iniziare

  • Scarica la libreria e gli strumenti di Cloud Endpoints Frameworks nella directory dell'app come descritto in Guida introduttiva a Endpoints Frameworks.
  • Assicurati di aver decorato correttamente il codice API con il codice dei framework previsti.

Generazione della libreria client

Le seguenti istruzioni mostrano come utilizzare lo strumento a riga di comando Endpoints Frameworks per generare un bundle client Gradle dal codice campione di Guida introduttiva a Cloud Endpoints.

Per generare una libreria client:

  1. Passa alla directory contenente il file app.yaml dell'API e le classi API.

  2. Esegui lo strumento a riga di comando Endpoints in modo simile al seguente:

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

    dove main è la classe contenente la tua API e EchoApi è il nome della tua API.

    Attendi che lo strumento generi la libreria. Se l'operazione va a buon fine, lo strumento mostra un messaggio simile a questo:

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

  3. Decomprimi il file utilizzando l'utilità di decompressione o un'altra utilità di decompressione compatibile con ZIP:

    unzip ./echo-v1-java.zip

  4. Cambia directory:

    cd echo

  5. Crea la libreria client:

    gradle build

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

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

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

Passaggi successivi

Per informazioni e codice campione che mostrano come accedere a un'API di backend da un client Python, consulta Accesso alle API di backend da client Python.