apollo-kotlin

Apollo Kotlin 技能為使用 Apollo Kotlin 程式庫 (v4+) 將 GraphQL 整合到 Android、JVM 和 Kotlin Multiplatform (KMP) 專案中提供了一個全面的框架。此技能專為行動開發者和後端開發者設計，簡化了從 GraphQL 操作和 schema 生成型別安全 Kotlin 模型的過程，確保跨異質平台的強健資料處理。它透過管理請求的全生命週期（從初始配置到執行時執行與快取管理），彌合了客戶端需求與遠端 GraphQL 服務之間的差距。

• 在 Gradle 專案中配置 Apollo Kotlin，包含對 Android、JVM 和 KMP 模組的支援。

• 管理 GraphQL schema 下載與程式碼生成設定，包括自定義純量對應與適配器配置。

• 建置並自定義包含身份驗證攔截器、請求日誌記錄與錯誤處理的 ApolloClient。

• 實現高效的資料擷取模式，包括使用 Kotlin Flow 的查詢 (Queries)、變更 (Mutations) 與反應式訂閱 (Subscriptions)。

• 設定並利用規範化快取 (Normalized Cache) 來實現離線優先能力、最佳化的狀態管理，以及跨應用程式畫面的資料一致性。

• 透過指令碼輔助工具管理與更新 Apollo Kotlin 程式庫版本及快取相依性。

• 確保所有 schema 與操作檔案皆已納入版本控制，以實現可重現的建置。

• 優先使用現代的 com.apollographql.cache 程式庫，而非舊版替代方案以獲得最佳效能。

• 在升級前使用提供的指令碼查詢 Apollo Kotlin 與規範化快取的可用版本。

• 應用 @typePolicy 指令來定義複雜物件的自定義快取鍵，確保規範化快取運作正常。

• 請務必使用 Apollo Kotlin v4 或更高版本，以利用最新的效能提升、API 穩定性與功能集。

• 透過整合測試與適當的錯誤處理來驗證所有網路相關邏輯，以區分網路故障與 GraphQL 特定錯誤。