Интеграция Adapty в приложение Flutter с помощью ИИ

Это руководство проведёт вас через интеграцию Adapty в приложение Flutter шаг за шагом с помощью ИИ-инструмента — вы передаёте ему нужную документацию Adapty в нужном порядке.

Перед началом: настройка дашборда

Adapty требует настройки дашборда до написания кода SDK. Это можно сделать с помощью интерактивного LLM-скилла или вручную через дашборд.

Через скилл (рекомендуется)

Скилл Adapty CLI позволяет LLM напрямую настроить приложение, продукты, уровни доступа, пейволы и плейсменты — без открытия дашборда на каждом шаге. Нужно только подключить сторы в дашборде.

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

После добавления скилла запустите /adapty-cli в агенте. Он проведёт вас через каждый шаг — включая момент, когда нужно открыть дашборд для подключения сторов.

Через дашборд

Если вы предпочитаете всё настраивать вручную, вот что нужно сделать до написания кода. LLM не может самостоятельно получить значения из дашборда — вам придётся предоставить их самостоятельно.

Подключите сторы: В дашборде Adapty перейдите в App settings → General. Подключите App Store и Google Play, если приложение поддерживает обе платформы. Это обязательное условие для работы покупок. Подключение сторов
Скопируйте публичный SDK-ключ: В дашборде Adapty перейдите в App settings → General и найдите раздел API keys. В коде это строка, которую вы передаёте в конфигурацию Adapty.
Создайте хотя бы один продукт: В дашборде Adapty перейдите на страницу Products. В коде продукты не указываются напрямую — Adapty доставляет их через пейволы. Добавление продуктов
Создайте флоу или пейвол и плейсмент: В дашборде Adapty создайте флоу (или пейвол, если вы строите UI самостоятельно), затем назначьте его плейсменту на странице Placements. В коде ID плейсмента — это строка, которую вы передаёте в Adapty().getFlow(). Создание пейвола
Настройте уровни доступа: В дашборде Adapty настройте их для каждого продукта на странице Products. В коде это строка, проверяемая в profile.accessLevels['premium']?.isActive. Уровень доступа premium по умолчанию подходит большинству приложений. Если платящие пользователи получают доступ к разным функциям в зависимости от продукта (например, план basic vs. pro), создайте дополнительные уровни доступа до начала разработки.

Tip

Когда всё пять пунктов выполнены, можно писать код. Скажите LLM: «Мой публичный SDK-ключ — X, ID плейсмента — Y», чтобы он сгенерировал корректный код инициализации и получения пейвола.

Что настроить позже

Эти вещи не нужны для начала разработки, но понадобятся по мере развития интеграции:

A/B-тесты: Настраиваются на странице Placements. Изменения в коде не требуются. A/B-тесты
Дополнительные флоу и плейсменты: Добавьте вызовы getFlow с разными ID плейсментов.
Интеграции с аналитикой: Настраиваются на странице Integrations. Процесс зависит от конкретной интеграции. См. интеграции с аналитикой и интеграции с атрибуцией.

Передайте документацию Adapty LLM

Через Context7 (рекомендуется)

Context7 — это MCP-сервер, который даёт LLM прямой доступ к актуальной документации Adapty. LLM автоматически подтягивает нужные документы на основе вашего запроса — вставлять ссылки вручную не нужно.

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

Warning

Даже если Context7 избавляет от необходимости вставлять ссылки вручную, порядок реализации важен. Следуйте пошаговому руководству по реализации ниже строго по шагам, чтобы всё работало корректно.

Через документацию в виде текста

Любую страницу документации Adapty можно получить в виде текста Markdown. Добавьте .md в конец URL или нажмите Copy for LLM под заголовком статьи. Например: adapty-cursor-flutter.md.

Каждый этап в пошаговом руководстве по реализации ниже содержит блок «Отправьте это LLM» со ссылками .md для вставки.

Для получения большего объёма документации сразу см. индексные файлы и платформо-специфичные подборки ниже.

Пошаговое руководство по реализации

Далее руководство проведёт через интеграцию Adapty в правильном порядке. Каждый этап включает документы для LLM, ожидаемый результат и типичные проблемы.

Спланируйте интеграцию

Прежде чем писать код, попросите LLM проанализировать проект и составить план реализации. Если ваш ИИ-инструмент поддерживает режим планирования (как в Cursor или Claude Code), используйте его — тогда LLM сможет изучить структуру проекта и документацию Adapty до написания кода.

Скажите LLM, какой подход к покупкам вы используете — это влияет на руководства, которые он должен изучить:

Adapty Flow & Paywall Builder: Вы создаёте флоу в no-code конструкторе Adapty, SDK отображает их автоматически.
Самостоятельно созданные пейволы: Вы строите UI пейвола в коде, но используете Adapty для получения продуктов и обработки покупок.
Observer mode: Вы сохраняете существующую инфраструктуру покупок и используете Adapty только для аналитики и интеграций.

Не знаете, что выбрать? Прочитайте таблицу сравнения в quickstart.

Установите и настройте SDK

Добавьте зависимость Adapty SDK с помощью flutter pub add и активируйте её с вашим публичным SDK-ключом. Это основа — без неё ничего не работает.

Руководство: Установка и настройка Adapty SDK

Отправьте это LLM:

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

Tip

Контрольная точка

Ожидаемый результат: Приложение собирается и запускается на iOS и Android. В консоли отладки виден лог активации Adapty.
Возможная проблема: «Public API key is missing» → проверьте, что вы заменили заглушку на реальный ключ из App settings.

Отобразите пейволы и обработайте покупки

Получите пейвол по ID плейсмента, отобразите его и обработайте события покупки. Нужные руководства зависят от выбранного подхода к покупкам.

Проверяйте каждую покупку в песочнице по ходу работы — не ждите конца. Инструкции по настройке см. в Тестирование покупок в песочнице.

Руководства:

Отправьте это LLM:

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

Tip

Контрольная точка

Ожидаемый результат: Пейвол отображается с настроенными продуктами. Нажатие на продукт вызывает диалог покупки в песочнице.
Возможная проблема: Пустой флоу или ошибка getFlow → убедитесь, что ID плейсмента точно совпадает с дашбордом и плейсменту назначена аудитория.

Руководства:

Отправьте это LLM:

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

Tip

Контрольная точка

Ожидаемый результат: Ваш пейвол отображает продукты, полученные от Adapty. Нажатие на продукт вызывает диалог покупки в песочнице.
Возможная проблема: Пустой массив продуктов → убедитесь, что пейволу назначены продукты в дашборде и плейсменту назначена аудитория.

Руководства:

Отправьте это LLM:

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

Tip

Контрольная точка

Ожидаемый результат: После покупки в песочнице через существующий флоу покупки транзакция появляется в Event Feed дашборда Adapty.
Возможная проблема: Нет событий → убедитесь, что транзакции передаются в Adapty и серверные уведомления настроены для обоих сторов.

Проверьте статус подписки

После покупки проверьте профиль пользователя на наличие активного уровня доступа, чтобы открыть доступ к премиум-контенту.

Руководство: Проверка статуса подписки

Отправьте это LLM:

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

Tip

Контрольная точка

Ожидаемый результат: После покупки в песочнице profile.accessLevels['premium']?.isActive возвращает true.
Возможная проблема: Пустой accessLevels после покупки → убедитесь, что продукту назначен уровень доступа в дашборде.

Идентифицируйте пользователей

Свяжите аккаунты пользователей вашего приложения с профилями Adapty, чтобы покупки сохранялись на всех устройствах.

Important

Пропустите этот шаг, если в приложении нет аутентификации.

Руководство: Идентификация пользователей

Отправьте это LLM:

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

Tip

Контрольная точка

Ожидаемый результат: После вызова Adapty().identify() в разделе Profiles дашборда отображается ваш пользовательский ID.
Возможная проблема: Вызывайте identify после активации, но до получения пейволов — иначе произойдёт неверная атрибуция анонимного профиля.

Подготовьтесь к релизу

Когда интеграция заработает в песочнице, пройдитесь по чеклисту для релиза, чтобы убедиться, что всё готово к production.

Руководство: Чеклист для релиза

Отправьте это LLM:

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

Tip

Контрольная точка

Ожидаемый результат: Все пункты чеклиста выполнены: подключение сторов, серверные уведомления, флоу покупки, проверки уровней доступа и требования конфиденциальности.
Возможная проблема: Отсутствие серверных уведомлений → настройте App Store Server Notifications в App settings → iOS SDK и Google Play Real-Time Developer Notifications в App settings → Android SDK.

Индексные файлы с документацией в виде текста

Если нужно дать LLM более широкий контекст помимо отдельных страниц, мы публикуем индексные файлы, которые перечисляют или объединяют всю документацию Adapty:

llms.txt: Список всех страниц со ссылками .md. Формирующийся стандарт для предоставления веб-сайтов LLM. Обратите внимание: для некоторых ИИ-агентов (например, ChatGPT) нужно скачать llms.txt и загрузить в чат как файл.
llms-full.txt: Вся документация Adapty в одном файле. Очень большой — используйте только когда нужна полная картина.
Flutter-специфичные flutter-llms.txt и flutter-llms-full.txt: Подборки для конкретной платформы, которые экономят токены по сравнению с полным сайтом.