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 遷移
指令碼
- list-apollo-kotlin-versions.sh - 列出 Apollo Kotlin 的版本
- list-apollo-kotlin-normalized-cache-versions.sh - 列出 Apollo Kotlin Normalized Cache 函式庫的版本
主要規則
- 偏好使用 Apollo Kotlin v5 或更新版本。請勿使用 v3 或更舊版本。
- 將 schema 和操作保留在版本控制中,以確保建置可重現。




