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:

  1. Altere o diretório para o diretório que contém seu arquivo app.yaml da API e as classes de API.

  2. 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
    
  3. 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
    
  4. Altere o diretório:

    cd echo
    
  5. 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.

  6. Adicione o JAR da biblioteca de clientes ao app.

  7. Repita essas etapas toda vez que você modificar o código da API.

Próximas etapas

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.