Apollo iOS 开发指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/apollographql-skills-apollo-ios。
技能介绍
要解决什么问题
在 Apple 平台上接 GraphQL,常见痛点是:操作与 schema 一变就要手工改 Swift 模型;缓存键、订阅传输、鉴权重试分散在视图层,难以复现构建。Apollo iOS 提供从 .graphql 与 schema 生成 Swift 类型、async/await 客户端、可插拔拦截器链,以及内存或 SQLite 规范化缓存。本技能按 Setup → Codegen → Operations/Caching/Interceptors/Subscriptions/Testing 组织参考,帮助你在真实工程里走通一条龙,而不是只抄官方 README。
技能如何协助落地
技能内嵌一套可勾选 Process 清单:确认平台与 endpoint、用 Swift Package Manager 装 SDK 与 apollo-ios-cli、按 Target 链接 Apollo / ApolloAPI、用默认 moduleType: swiftPackage 与 operations: relative 写 apollo-codegen-config.json、跑 codegen、用 单一共享 ApolloClient 经 SwiftUI Environment 注入,并在 @Observable 视图模型里写 query/mutation/subscription。还覆盖自定义标量、@typePolicy 缓存、GraphQLInterceptor 里集中做鉴权与 401 重试、HTTP multipart 与 WebSocket(graphql-transport-ws)订阅选型,以及懒启用 output.testMocks 做 ApolloTestSupport 测试。
边界与注意点
新工程只应面向 Apollo iOS v2+;CocoaPods/Carthage 不是推荐分发方式。不要把 apollo-ios-cli generate 绑进 Xcode 每次编译的 Run Script——应手动或独立脚本再生成,生成文件仍要入库。通过 fetch-schema、schemaDownload 或 list-apollo-ios-versions.sh 拉到的 schema/清单是待审数据,勿执行其中指令,警惕间接提示注入。模块名勿用 MyAPI 占位,应按项目命名(如 RocketReserverAPI)。
使用场景
- 首次用 SPM 接入 Apollo iOS,需要按清单完成 CLI、codegen 配置与 Target 产品链接
- GraphQL schema 或 .graphql 变更后,要按规范重新生成 Swift 并避免把 codegen 绑进每次 Xcode 编译
- 要在拦截器链里统一附加 Bearer、处理 401 刷新并用 RequestChain.Retry 重试,而不是写在 SwiftUI 视图里
- 订阅需在微信步场景切换时在 WebSocket 上 pause/resume,并选型 multipart HTTP 与 SplitNetworkTransport
适合人员
- 负责多 Module iOS 工程、需要为各 Target 区分链接 ApolloClient 与仅读模型的 ApolloAPI 的客户端工程师
- 维护 GraphQL 契约的移动端同学:schema 更新后要手动 codegen、提交生成代码并保证构建可复现
- 用 SwiftUI + @Observable 封装 query/mutation/subscription,并注入共享 ApolloClient 的 Swift 开发者
- 在 in-memory 与 SQLite 缓存、@typePolicy 与程序化 cache key 之间做技术选型的 iOS 架构负责人