Guide Apollo Kotlin
Apollo Kotlin est un client GraphQL fortement typé qui génère des modèles Kotlin à partir de vos opérations et schémas GraphQL, pouvant être utilisés dans des projets Android, JVM et Kotlin Multiplatform.
Processus
Suivez ce processus lors de l'ajout ou du travail avec Apollo Kotlin :
- [ ] Confirmer les plates-formes cibles (Android, JVM, KMP), le ou les endpoints GraphQL et la façon dont les schémas sont sourcés.
- [ ] Configurer Gradle et la génération de code, y compris les scalaires personnalisés
- [ ] Créer un
ApolloClientpartagé avec authentification, logging et cache. - [ ] Implémenter les opérations.
- [ ] Valider le comportement avec les tests et la gestion des erreurs.
Fichiers de référence
- Setup - Plugin Gradle, téléchargement de schéma, configuration de codegen (y compris les scalaires), configuration du client (auth, logging, intercepteurs)
- Operations - Queries, mutations, subscriptions, et comment les exécuter
- Caching - Configuration et utilisation du cache normalisé
Scripts
- list-apollo-kotlin-versions.sh - Lister les versions d'Apollo Kotlin
- list-apollo-kotlin-normalized-cache-versions.sh - Lister les versions de la bibliothèque Apollo Kotlin Normalized Cache
Règles clés
- Utiliser Apollo Kotlin v4+, ne pas utiliser les versions v3 ou plus anciennes.
- Conserver le schéma et les opérations dans le contrôle de source pour rendre les builds reproductibles.