Strumento a riga di comando Cloud Endpoints Frameworks per App Engine

Questa pagina descrive come generare una libreria client dall'API del server di backend utilizzando lo strumento a riga di comando Endpoints Frameworks. Qualsiasi app Java o Android può utilizzare questa libreria per chiamare l'API.

Puoi generare bundle di librerie client che consentono alle applicazioni di accedere alla tua API utilizzando lo strumento a riga di comando Endpoints Frameworks. Quando generi una libreria client, lo strumento a riga di comando Endpoints Frameworks genera automaticamente un documento di rilevamento che descrive la superficie della tua API.

Per ottenere lo strumento a riga di comando Endpoints Frameworks, scarica endpoints-framework-tools dal Maven Central Repository. Dopo aver estratto i contenuti del file ZIP, lo strumento si trova nella directory endpoints-framework-tools-2.2.1/bin/.

Generare un bundle di librerie client da un'API

Puoi utilizzare lo strumento a riga di comando Endpoints Frameworks per generare i seguenti tipi di bundle client:

  • Maven: questo bundle include un file pom.xml con le dipendenze di Endpoints Frameworks e della libreria client delle API di Google. Il file readme.html fornisce informazioni dettagliate su cosa devi aggiungere al file pom.xml per diversi tipi di applicazioni client e su come creare una libreria client per la tua API utilizzando Maven.

  • Gradle: questo bundle include un file build.gradle con le dipendenze di Endpoints Frameworks e della libreria client delle API di Google. Il file readme.html fornisce informazioni dettagliate su cosa devi aggiungere al file build.gradle per diversi tipi di applicazioni client e su come creare una libreria client per la tua API utilizzando Gradle.

  • Bundle client predefinito: questo bundle contiene tutte le librerie delle dipendenze e il file source.jar generato, ovvero la libreria Java che utilizzi nel client per chiamare l'API. Questo bundle fornisce al client tutte le funzionalità della libreria client delle API di Google, incluso OAuth. Il file readme.html elenca i file .jar necessari per i diversi tipi di applicazioni client e altri dettagli per l'utilizzo della libreria client.

Se utilizzi la libreria client con un'app per Android, ti consigliamo di utilizzare un bundle client Gradle.

Sintassi della riga di comando

Prima di utilizzare lo strumento a riga di comando Endpoints Frameworks, devi creare il progetto di backend perché questo strumento richiede i file binari compilati. Se non vuoi utilizzare la directory predefinita (--war="./war"), puoi fornire facoltativamente l'opzione