Generazione di una libreria client

Questa pagina descrive come generare una libreria client dall'API di backend Python (il codice in esecuzione sul server). Qualsiasi app Java o Android può utilizzare questa biblioteca per chiamare l'API.

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

Prima di iniziare

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

Generazione della libreria client

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

Per generare una libreria client:

  1. Cambia directory e vai alla directory contenente il file app.yaml dell'API e le classi dell'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 l'API e EchoApi è il nome dell'API.

    Attendi che lo strumento generi la libreria. In caso di esito positivo, lo strumento mostra un messaggio simile al seguente:

    API client library written to ./echo-v1.zip
    
  3. Estrai il file utilizzando l'utilità unzip o un'altra utility di scompattazione compatibile con ZIP:

    unzip ./echo-v1-java.zip
    
  4. Cambia directory:

    cd echo
    
  5. Compila la libreria client:

    gradle build
    

    L'output si trova nella directory build/libs. Il nome file esatto 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 Accedere alle API di backend dai client Python.