Nesta página, mostramos como gerar uma biblioteca de cliente pelo back-end da API. Qualquer app para Java ou Android pode usar essa biblioteca para chamar a API.
Para criar clientes iOS para a API, recomendamos que você use a biblioteca de cliente Objective-C das APIs do Google para APIs REST.
Antes de começar
- Configure o ambiente de desenvolvimento.
- Verifique se você anotou sua API corretamente.
Como gerar a biblioteca de cliente
As instruções a seguir mostram como usar os plug-ins Apache Maven e Gradle do Cloud Endpoints Frameworks para gerar um pacote de cliente do Gradle com base no projeto de amostra do Maven em Primeiros passos com o Endpoints.
Para gerar uma biblioteca de cliente:
Crie sua API.
Execute a ferramenta de linha de comando do Endpoints Frameworks de forma semelhante à seguinte:
Maven
mvn endpoints-framework:clientLibs
Gradle
gradle endpointsClientLibs
Aguarde a ferramenta gerar a biblioteca. Quando terminar, uma mensagem como esta será exibida:
Maven
API client library written to target/client-libs/echo-v1-java.zip
Gradle
API client library written to build/endpointsClientLibs/echo-v1-java.zip
Descompacte o arquivo usando o utilitário de descompactação ou use outro utilitário de desarquivamento compatível com ZIP:
unzip ./echo-v1-java.zip
Altere o diretório:
cd echo
Crie a biblioteca de cliente:
Maven
mvn clean package
A saída está no diretório
target/
. O nome do arquivo exato depende da versão do cliente Java. É algo semelhante aecho-v1-1.23.0-SNAPSHOT.jar
.Gradle
gradle build
A saída está no diretório
build/libs
. O nome de arquivo exato depende da versão do cliente Java. É algo semelhante aecho-v1-1.23.0-SNAPSHOT.jar
.Adicione o JAR da biblioteca cliente ao seu aplicativo Java ou Android.
Repita essas etapas toda vez que você modificar o código da API.
A seguir
- Chame a API de back-end por um app para Android.
- Saiba mais sobre o Cloud Endpoints Frameworks para App Engine.