apollo-kotlin

apollo-kotlin

热门

使用 Apollo Kotlin(适用于 Android 和 Kotlin 的 GraphQL 客户端库)构建应用程序的指南。在以下情况下使用此技能:(1) 在 Android、Kotlin/JVM 或 KMP 的 Gradle 项目中设置 Apollo Kotlin,(2) 为 GraphQL 服务配置 schema 下载和代码生成,(3) 配置带有认证、拦截器和缓存的 `ApolloClient`,(4) 编写查询、变更或订阅。

108Star
12Fork
更新于 2026/7/29
SKILL.md
只读
名称
apollo-kotlin
描述

使用 Apollo Kotlin(适用于 Android 和 Kotlin 的 GraphQL 客户端库)构建应用程序的指南。在以下情况下使用此技能:(1) 在 Android、Kotlin/JVM 或 KMP 的 Gradle 项目中设置 Apollo Kotlin,(2) 为 GraphQL 服务配置 schema 下载和代码生成,(3) 配置带有认证、拦截器和缓存的 `ApolloClient`,(4) 编写查询、变更或订阅。

Apollo Kotlin 指南

Apollo Kotlin 是一个强类型 GraphQL 客户端,它根据你的 GraphQL 操作和 schema 生成 Kotlin 模型,可用于 Android、JVM 和 Kotlin Multiplatform 项目。

流程

在添加或使用 Apollo Kotlin 时,请遵循以下流程:

  • [ ] 确认目标平台(Android、JVM、KMP)、GraphQL 端点以及 schema 的来源方式。
  • [ ] 配置 Gradle 和代码生成,包括自定义标量。
  • [ ] 创建一个共享的 ApolloClient,包含认证、日志记录和缓存。
  • [ ] 实现操作。
  • [ ] 通过测试和错误处理验证行为。

参考文件

  • 设置 - Gradle 插件、schema 下载、代码生成配置(包括标量)、客户端配置(认证、日志记录、拦截器)
  • 操作 - 查询、变更、订阅及其执行方式
  • 缓存 - 设置和使用规范化缓存
  • 迁移指南 - 从 Apollo Kotlin 4 迁移

脚本

关键规则

  • 优先使用 Apollo Kotlin v5+。不要使用 v3 或更早版本。
  • 将 schema 和操作保存在源代码控制中,以确保构建可重现。