mcpField
A
apollo-kotlin

apollo-kotlin

github.com/apollographql开发1211.7k 次安装1 天前更新
代码仓库

关于 apollo-kotlin

这是 Apollo Kotlin 的使用指南,介绍从 GraphQL schema 和操作生成 Kotlin 模型的强类型客户端。内容涵盖 Android、JVM 和 Kotlin Multiplatform 项目的配置、实现与测试。

主要功能

  1. 01Gradle 与代码生成配置
  2. 02ApolloClient 配置
  3. 03查询、变更与订阅
  4. 04规范化缓存指南
  5. 05从 Apollo Kotlin 4 迁移

适用场景

  1. 01为 Kotlin 项目添加 GraphQL 支持
  2. 02配置身份验证、日志与缓存
  3. 03实现并测试 GraphQL 操作

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/apollographql/skills --skill apollo-kotlin

安装后在 Claude Code 中输入/apollo-kotlin确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
caching.md
migrating-from-4.md
operations.md
setup.md
scripts/
list-apollo-kotlin-normalized-cache-versions.sh
list-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 迁移

脚本

关键规则

  • 优先使用 Apollo Kotlin v5+。不要使用 v3 或更早版本。
  • 将架构和操作纳入源代码管理,以确保构建可复现。

评论

支持 Markdown