关于 apollo-kotlin
这是 Apollo Kotlin 的使用指南,介绍从 GraphQL schema 和操作生成 Kotlin 模型的强类型客户端。内容涵盖 Android、JVM 和 Kotlin Multiplatform 项目的配置、实现与测试。
主要功能
- 01Gradle 与代码生成配置
- 02ApolloClient 配置
- 03查询、变更与订阅
- 04规范化缓存指南
- 05从 Apollo Kotlin 4 迁移
适用场景
- 01为 Kotlin 项目添加 GraphQL 支持
- 02配置身份验证、日志与缓存
- 03实现并测试 GraphQL 操作
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ apollographql/ skills --skill apollo-kotlin安装后在 Claude Code 中输入/apollo-kotlin确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/caching.mdmigrating-from-4.mdoperations.mdsetup.mdscripts/list-apollo-kotlin-normalized-cache-versions.shlist-apollo-kotlin-versions.sh详细介绍
Apollo Kotlin 指南
Apollo Kotlin 是一款强类型 GraphQL 客户端,可根据 GraphQL 操作和架构生成 Kotlin 模型,供 Android、JVM 和 Kotlin Multiplatform 项目使用。
流程
添加或使用 Apollo Kotlin 时,请遵循以下流程:
- 确认目标平台(Android、JVM、KMP)、GraphQL 端点以及架构的来源。
- 配置 Gradle 和代码生成,包括自定义标量
- 创建共享的
ApolloClient,配置身份验证、日志记录和缓存。 - 实现操作。
- 通过测试和错误处理验证行为。
参考文件
- 设置 - Gradle 插件、架构下载、代码生成配置(包括标量)、客户端配置(身份验证、日志记录、拦截器)
- 操作 - 查询、变更、订阅及其执行方式
- 缓存 - 设置和使用规范化缓存
- 迁移指南 - 从 Apollo Kotlin 4 迁移
脚本
- list-apollo-kotlin-versions.sh - 列出 Apollo Kotlin 的版本
- list-apollo-kotlin-normalized-cache-versions.sh - 列出 Apollo Kotlin Normalized Cache 库的版本
关键规则
- 优先使用 Apollo Kotlin v5+。不要使用 v3 或更早版本。
- 将架构和操作纳入源代码管理,以确保构建可复现。
评论
支持 Markdown