AgentSkillsCN

apollo-kotlin

指南：使用Apollo Kotlin构建应用，Apollo Kotlin是适用于Android与Kotlin的GraphQL客户端库。当用户：(1)在Gradle项目中为Android、Kotlin/JVM或KMP设置Apollo Kotlin时，(2)为GraphQL服务配置模式下载与代码生成，(3)使用auth、拦截器与缓存配置`ApolloClient`，(4)编写查询、变更或订阅时，可使用此技能。

SKILL.md
--- frontmatter
name: apollo-kotlin
description: >
  Guide for building applications with Apollo Kotlin, the GraphQL client library for Android and Kotlin. Use this skill when:
  (1) setting up Apollo Kotlin in a Gradle project for Android, Kotlin/JVM, or KMP,
  (2) configuring schema download and codegen for GraphQL services,
  (3) configuring an `ApolloClient` with auth, interceptors, and caching,
  (4) writing queries, mutations, or subscriptions,
license: MIT
compatibility: JVM 8+, Kotlin 1.9+, Gradle 8+, Android/JVM/Kotlin Multiplatform projects.
metadata:
  author: apollographql
  version: "1.0.1"
allowed-tools: Bash(./gradlew:*) Bash(gradle:*) Bash(curl:*) Read Write Edit Glob Grep WebFetch

Apollo Kotlin Guide

Apollo Kotlin is a strongly typed GraphQL client that generates Kotlin models from your GraphQL operations and schema, that can be used in Android, JVM, and Kotlin Multiplatform projects.

Process

Follow this process when adding or working with Apollo Kotlin:

  • • Confirm target platforms (Android, JVM, KMP), GraphQL endpoint(s), and how schemas are sourced.
  • • Configure Gradle and code generation, including custom scalars
  • • Create a shared ApolloClient with auth, logging, and caching.
  • • Implement operations.
  • • Validate behavior with tests and error handling.

Reference Files

  • •Setup - Gradle plugin, schema download, codegen config (including scalars), client configuration (auth, logging, interceptors)
  • •Operations - Queries, mutations, subscriptions, and how to execute them
  • •Caching - Setup and use the normalized cache

Scripts

Key Rules

  • •Use Apollo Kotlin v4+, do not use v3 or older versions.
  • •Keep schema and operations in source control to make builds reproducible.