Puoi generare bundle di librerie client che consentono alle applicazioni di accedere all'API utilizzando lo strumento a riga di comando di Endpoints Frameworks. Quando generi una libreria client, lo strumento a riga di comando di Endpoints Frameworks genera automaticamente un documento di rilevamento che descrive la superficie della tua API.
Per ottenere lo strumento a riga di comando di Endpoints Frameworks, scarica
endpoints-framework-tools
dal repository centrale di Maven.
Dopo aver estratto i contenuti del file ZIP, lo strumento si trova nella directory endpoints-framework-tools-2.2.1/bin/
.
Generazione di un bundle di libreria client da un'API
Puoi utilizzare lo strumento a riga di comando di 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 filereadme.html
fornisce informazioni dettagliate su ciò che devi aggiungere al filepom.xml
per diversi tipi di applicazioni client e su come creare una libreria client per la tua API utilizzando Maven.Gradle: questo pacchetto include un file
build.gradle
con le dipendenze dei framework degli endpoint e delle dipendenze delle librerie client delle API di Google. Il filereadme.html
fornisce informazioni dettagliate su ciò che devi aggiungere al tuo filebuild.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 di dipendenze e il file
source.jar
generato, che è la libreria Java che utilizzi nel client per chiamare l'API. Questo pacchetto fornisce al client tutte le funzionalità della libreria client delle API di Google, tra cui OAuth. Il filereadme.html
elenca i file.jar
necessari per 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 di Endpoints Frameworks, devi creare il tuo progetto di backend, poiché questo strumento richiede la compilazione di programmi binari. Facoltativamente, puoi fornire l'opzione --war=
che punta alla directory di output della destinazione della build contenente la directory WEB-INF
e le classi Java compilate, se non vuoi utilizzare l'output predefinito (--war="./war"
).
La sintassi di base è la seguente:
/path-to/endpoints-framework-tools-2.2.1/bin/endpoints-framework-tools \ get-client-lib OPTIONS CLASS_NAME
dove:
OPTIONS
, se fornito, corrisponde a uno o più elementi mostrati nella tabella Opzioni.CLASS_NAME
è il nome completo della classe della tua API.
Ad esempio:
/path-to/endpoints-framework-tools-2.2.1/bin/endpoints-framework-tools \
get-client-lib --war=target/echo-1.0-SNAPSHOT -bs gradle com.example.echo.Echo
dove target/echo-1.0-SNAPSHOT
è il percorso relativo o assoluto della directory della build di destinazione contenente WEB-INF
e le classi di backend compilate.
Opzioni
Puoi utilizzare le seguenti opzioni:
Nome opzione | Descrizione | Esempio |
---|---|---|
build-system |
Consente di specificare il tipo di bundle client da generare. Specifica gradle per un bundle client Gradle per Android, maven per un bundle client Maven oppure default (o ometti semplicemente questa opzione) per un bundle che contiene solo le librerie delle dipendenze e il jar di origine. |
--build-system=gradle -bs gradle |
war |
Imposta il percorso della directory di destinazione della build WEB-INF che contiene appengine-web.xml e altri metadati.Predefinito: ./war . |
--war=target/echo-1.0-SNAPSHOT -w target/echo-1.0-SNAPSHOT |
output |
Imposta la directory in cui viene scritto l'output. Predefinito: la directory da cui viene richiamato lo strumento. |
--output=/mydir -o /mydir |
Piattaforme client supportate
Nel bundle client prodotto dallo strumento a riga di comando di Endpoint Frameworks sono supportate le seguenti piattaforme:
- Java 7 e versioni successive:
- Android 1.6 e versioni successive.
- App Engine.