Gerar uma biblioteca de cliente

Esta página descreve como gerar uma biblioteca de cliente a partir de sua API de back-end do Python (o código executado no servidor). Qualquer aplicativo 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

Faça o download da biblioteca e das ferramentas do Cloud Endpoints Frameworks no diretório do aplicativo, conforme descrito em Primeiros passos com o Endpoints Frameworks.
Verifique se você decorou corretamente o código da API com o código esperado do Frameworks.

Gerar biblioteca de clientes

As instruções a seguir demonstram como usar a ferramenta de linha de comando do Endpoints Frameworks para gerar um pacote do cliente Gradle a partir do código de exemplo em Primeiros passos com o Cloud Endpoints.

Para gerar uma biblioteca cliente:

Altere o diretório para o diretório que contém seu arquivo app.yaml da API e as classes de API.
Execute a ferramenta de linha de comando Endpoints semelhante à seguinte:
```
python lib/endpoints/endpointscfg.py get_client_lib java -bs gradle main.EchoApi
```
em que main é a classe que contém a API e EchoApi é o nome da API.

Aguarde a ferramenta gerar a biblioteca. Quando terminar, uma mensagem como esta será exibida:
```
API client library written to ./echo-v1.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:
```
gradle build
```
A saída está no diretório build/libs. O nome exato depende da versão do cliente. É semelhante a echo-v1-1.23.0-SNAPSHOT.jar.
Adicione o JAR da biblioteca de clientes ao app.
Repita essas etapas toda vez que você modificar o código da API.

A seguir

Para informações exemplos de código que mostram como acessar uma API de back-end a partir de um cliente Python, consulte Como acessar APIs de back-end de clientes Python.