apollo-kotlin について
Apollo Kotlinの利用方法をまとめたスキルです。GraphQLのスキーマとオペレーションからKotlinモデルを生成する型付きクライアントについて、Android、JVM、Kotlin Multiplatformでの設定からテストまで扱います。
主な機能
- 01Gradleとコード生成の設定
- 02ApolloClientの構成
- 03クエリ、ミューテーション、サブスクリプション
- 04正規化キャッシュのガイド
- 05Apollo Kotlin 4からの移行
活用シーン
- 01KotlinプロジェクトへのGraphQL導入
- 02認証、ログ、キャッシュの設定
- 03GraphQLオペレーションの実装とテスト
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ apollographql/ skills --skill apollo-kotlinインストール後、Claude Code で/apollo-kotlinを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/caching.mdmigrating-from-4.mdoperations.mdsetup.mdscripts/list-apollo-kotlin-normalized-cache-versions.shlist-apollo-kotlin-versions.sh詳細
Apollo Kotlin ガイド
Apollo Kotlin は、GraphQL のオペレーションとスキーマから Kotlin モデルを生成する、型安全性の高い GraphQL クライアントです。Android、JVM、Kotlin Multiplatform のプロジェクトで使用できます。
プロセス
Apollo Kotlin を追加または使用する際は、次の手順に従ってください。
- 対象プラットフォーム(Android、JVM、KMP)、GraphQL エンドポイント、スキーマの取得元を確認します。
- カスタムスカラーを含め、Gradle とコード生成を設定します。
- 認証、ロギング、キャッシュを設定した共有の
ApolloClientを作成します。 - オペレーションを実装します。
- テストとエラー処理で動作を検証します。
参照ファイル
- セットアップ - Gradle プラグイン、スキーマのダウンロード、コード生成の設定(スカラーを含む)、クライアントの設定(認証、ロギング、インターセプター)
- オペレーション - クエリ、ミューテーション、サブスクリプション、およびそれらの実行方法
- キャッシュ - 正規化キャッシュのセットアップと使用方法
- 移行ガイド - 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 以前のバージョンは使用しないでください。
- ビルドを再現可能にするため、スキーマとオペレーションをソース管理に含めてください。
コメント
Markdown 対応