AIアシスタントを使ってAdaptyをFlutterアプリに統合する

このガイドでは、AIコーディングツールを使ってAdaptyをFlutterアプリにステップバイステップで統合する方法を説明します。適切なAdaptyドキュメントを正しい順序でAIに渡していきます。

始める前に：ダッシュボードの設定

AdaptyはSDKのコードを書く前に、ダッシュボードでいくつかの設定が必要です。インタラクティブなLLMスキルを使うか、ダッシュボードで手動設定するかを選べます。

スキルを使う方法（推奨）

Adapty CLIスキルを使うと、LLMがダッシュボードを開かずに直接アプリ、プロダクト、アクセスレベル、ペイウォール、プレースメントを設定できます。必要なのは、ダッシュボードでストアを接続することだけです。

npx skills add adaptyteam/adapty-cli --skill adapty-cli

スキルを追加したら、エージェントで /adapty-cli を実行します。ダッシュボードでストアを接続するタイミングも含め、各ステップをガイドしてくれます。

ダッシュボードを使う方法

手動で設定したい場合は、コードを書く前に以下の手順を完了させてください。ダッシュボードの値はLLMが調べることはできないため、自分で用意する必要があります。

1. ストアを接続する: Adapty ダッシュボードで App settings → General に移動します。FlutterアプリがiOSとAndroidの両方を対象としている場合は、App StoreとGoogle Playの両方を接続してください。購入機能を動作させるために必要です。 ストアを接続する

2. Public SDKキーをコピーする: Adapty ダッシュボードで App settings → General に移動し、API keys セクションを確認します。コードでは、このキーをAdapty設定に渡します。

3. プロダクトを1つ以上作成する: Adapty ダッシュボードで Products ページに移動します。コードでプロダクトを直接参照することはなく、Adaptyはペイウォールごしにプロダクトをデリバリーします。 プロダクトを追加する

4. ペイウォールとプレースメントを作成する: Adapty ダッシュボードで Paywalls ページにペイウォールを作成し、Placements ページでプレースメントに割り当てます。コードでは、プレースメントIDを Adapty().getPaywall() に渡す文字列として使います。 ペイウォールを作成する

5. アクセスレベルを設定する: Adapty ダッシュボードの Products ページでプロダクトごとに設定します。コードでは profile.accessLevels['premium']?.isActive でチェックする文字列です。デフォルトの premium アクセスレベルはほとんどのアプリで使えます。プロダクトによって利用できる機能が異なる場合（たとえば basic プランと pro プラン）は、コーディングを始める前に追加のアクセスレベルを作成してください。

準備ができたら設定するもの

これらはコーディングを始めるために必須ではありませんが、統合が進むにつれて必要になります。

• A/Bテスト: Placements ページで設定します。コードの変更は不要です。 A/Bテスト
• 追加のペイウォールとプレースメント: 異なるプレースメントIDで getPaywall の呼び出しを追加します。
• アナリティクス統合: Integrations ページで設定します。統合によって手順が異なります。アナリティクス統合およびアトリビューション統合を参照してください。

AdaptyドキュメントをLLMに渡す

Context7を使う（推奨）

Context7は、LLMに最新のAdaptyドキュメントへの直接アクセスを提供するMCPサーバーです。質問内容に応じて適切なドキュメントをLLMが自動的に取得するため、URLを手動でペーストする必要はありません。

Context7はCursor、Claude Code、Windsurf、その他のMCP対応ツールで動作します。セットアップするには次を実行します。

npx ctx7 setup

これにより、エディタを自動検出してContext7サーバーを設定します。手動でのセットアップはContext7 GitHubリポジトリを参照してください。

設定が完了したら、プロンプトでAdaptyライブラリを参照します。

Use the adaptyteam/adapty-docs library to look up how to install the Flutter SDK

プレーンテキストのドキュメントを使う

AdaptyのドキュメントはプレーンテキストのMarkdownとして取得できます。URLの末尾に .md を追加するか、記事タイトルの下にある Copy for LLM をクリックしてください。例: adapty-cursor-flutter.md

以下の実装ウォークスルーの各ステージには「LLMに送る」ブロックがあり、ペーストできる .md リンクが含まれています。

まとめて多くのドキュメントが必要な場合は、以下のインデックスファイルとプラットフォーム別サブセットを参照してください。

実装ウォークスルー

このガイドの残りの部分では、実装の順序でAdaptyの統合を進めます。各ステージには、LLMに送るドキュメント、完了時に確認できること、よくある問題が含まれています。

統合の計画を立てる

コードを書き始める前に、LLMにプロジェクトを分析させて実装計画を作成してもらいましょう。AIツールに計画モード（CursorやClaude Codeのプランモードなど）がある場合は活用してください。コードを書く前にLLMがプロジェクト構造とAdaptyドキュメントの両方を読めます。

購入に使うアプローチをLLMに伝えてください。これにより、参照するガイドが変わります。

• Adapty ペイウォールビルダー: Adaptyのノーコードビルダーでペイウォールを作成し、SDKが自動的にレンダリングします。
• 手動作成のペイウォール: 独自のペイウォールUIをコードで構築しつつ、プロダクトの取得と購入処理にAdaptyを使います。
• オブザーバーモード: 既存の購入インフラをそのまま使い、アナリティクスと統合にのみAdaptyを使います。

どれを選べばよいかわからない場合は、クイックスタートの比較表を参照してください。

SDKのインストールと設定

flutter pub add でAdapty SDKの依存関係を追加し、Public SDKキーで有効化します。これが基盤となり、ここなしには何も動きません。

ガイド: Adapty SDKのインストールと設定

LLMに送る内容:

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/sdk-installation-flutter.md

ペイウォールの表示と購入の処理

プレースメントIDでペイウォールを取得し、表示して、購入イベントを処理します。必要なガイドは購入の処理方法によって異なります。

進める中でサンドボックスでの購入テストを都度行ってください。最後まで待たないようにしましょう。設定手順はサンドボックスで購入テストするを参照してください。

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/flutter-quickstart-paywalls.md
- https://adapty.io/docs/ja/flutter-get-pb-paywalls.md
- https://adapty.io/docs/ja/flutter-present-paywalls.md
- https://adapty.io/docs/ja/flutter-handling-events.md
- https://adapty.io/docs/ja/flutter-handle-paywall-actions.md

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/flutter-quickstart-manual.md
- https://adapty.io/docs/ja/fetch-paywalls-and-products-flutter.md
- https://adapty.io/docs/ja/present-remote-config-paywalls-flutter.md
- https://adapty.io/docs/ja/flutter-making-purchases.md
- https://adapty.io/docs/ja/flutter-restore-purchase.md

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/observer-vs-full-mode.md
- https://adapty.io/docs/ja/implement-observer-mode-flutter.md
- https://adapty.io/docs/ja/report-transactions-observer-mode-flutter.md

サブスクリプションステータスを確認する

購入後、ユーザープロファイルのアクティブなアクセスレベルを確認してプレミアムコンテンツを制限します。

ガイド: サブスクリプションステータスを確認する

LLMに送る内容:

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/flutter-check-subscription-status.md

ユーザーを識別する

アプリのユーザーアカウントをAdaptyプロファイルに紐付けて、デバイスをまたいで購入が維持されるようにします。

ガイド: ユーザーを識別する

LLMに送る内容:

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/flutter-quickstart-identify.md

リリースの準備をする

サンドボックスでの統合が動作したら、リリースチェックリストを確認してすべてが本番環境で問題ないことを確かめます。

ガイド: リリースチェックリスト

LLMに送る内容:

Read these Adapty docs before releasing:
- https://adapty.io/docs/ja/release-checklist.md

プレーンテキストのドキュメントインデックスファイル

個別ページを超えてLLMに広いコンテキストを提供したい場合は、すべてのAdaptyドキュメントを一覧化または統合したインデックスファイルを用意しています。

• llms.txt: .md リンクつきで全ページを一覧表示します。LLMがウェブサイトにアクセスしやすくするための新興標準です。一部のAIエージェント（ChatGPTなど）では llms.txt をダウンロードしてチャットにファイルとしてアップロードする必要があります。
• llms-full.txt: Adaptyドキュメントサイト全体を1つのファイルに統合したものです。非常に大きいため、全体像が必要な場合のみ使用してください。
• Flutter専用の flutter-llms.txt と flutter-llms-full.txt: サイト全体よりもトークンを節約できるプラットフォーム別サブセットです。