apollo-kotlin

apollo-kotlin

熱門

使用 Apollo Kotlin(適用於 Android 和 Kotlin 的 GraphQL 用戶端函式庫)建置應用程式的指南。在下列情況使用此技能:(1) 在 Android、Kotlin/JVM 或 KMP 的 Gradle 專案中設定 Apollo Kotlin,(2) 設定 GraphQL 服務的 schema 下載與程式碼產生,(3) 設定具備驗證、攔截器和快取的 `ApolloClient`,(4) 撰寫查詢、變更或訂閱。

108星標
12分支
更新於 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 和操作保留在版本控制中,以確保建置可重現。