Cette page explique comment générer une bibliothèque cliente à partir de votre API backend Python (correspondant au code exécuté sur le serveur). Toute application Java ou Android peut utiliser cette bibliothèque pour appeler l'API.
Pour créer des clients iOS pour votre API, nous vous recommandons d'utiliser la bibliothèque cliente Objective-C des API Google pour les API REST.
Avant de commencer
- Téléchargez la bibliothèque et les outils Cloud Endpoints Frameworks dans le répertoire de votre application, comme indiqué dans la section Premiers pas avec Endpoints Frameworks.
- Assurez-vous que le code de votre API est correctement décoré avec le code Frameworks attendu.
Générer la bibliothèque cliente
Les instructions suivantes montrent comment utiliser l'outil de ligne de commande Endpoints Frameworks pour générer un ensemble de clients Gradle à partir de l'exemple de code fourni à la page Premiers pas avec Cloud Endpoints.
Pour générer une bibliothèque cliente :
Remplacez le répertoire par celui qui contient votre fichier
app.yaml
et les classes de l'API.Exécutez l'outil de ligne de commande Endpoints semblable à celui-ci :
python lib/endpoints/endpointscfg.py get_client_lib java -bs gradle main.EchoApi
où
main
est la classe contenant votre API, etEchoApi
est le nom de cette API.Patientez le temps que l'outil génère la bibliothèque. Si l'opération aboutit, l'outil affiche un message semblable à celui-ci :
API client library written to ./echo-v1.zip
Décompressez le fichier à l'aide de l'utilitaire unzip ou d'un autre utilitaire de désarchivage compatible ZIP :
unzip ./echo-v1-java.zip
Changez de répertoire :
cd echo
Créez la bibliothèque cliente :
gradle build
La sortie se trouve dans le répertoire
build/libs
. Le nom exact du fichier dépendra de la version du client, Le résultat est semblable àecho-v1-1.23.0-SNAPSHOT.jar
.Ajoutez le fichier JAR de la bibliothèque cliente à votre application.
Répétez ces étapes chaque fois que vous modifiez le code de l'API.
Étape suivante
Pour obtenir plus d'informations et découvrir un exemple de code montrant comment accéder à une API backend à partir d'un client Python, consultez la page Accéder aux API backend à partir des clients Python.