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

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

Per generare una libreria client:

  1. Cambia directory nella directory contenente il file app.yaml dell'API e le classi API.

  2. Esegui lo strumento a riga di comando di 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 visualizza un messaggio simile a questo:

    API client library written to ./echo-v1.zip
    
  3. Decomprimi il file utilizzando l'utilità di decompressione oppure utilizza un'altra utilità di disarchiviazione compatibile con file 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 file esatto dipende dalla versione del client. È simile a echo-v1-1.23.0-SNAPSHOT.jar.

  6. Aggiungi la libreria client JAR alla tua app.

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

Passaggi successivi

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