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

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

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

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

Подход со скиллом (рекомендуется)

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

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

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

CLI для скиллов не обновляет скилл автоматически. Чтобы получить последнюю версию, выполните npx skills update.

Подход через дашборд

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

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

Tip

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

Настройте по мере необходимости

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

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

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

Используйте Context7 (рекомендуется)

Context7 — это MCP-сервер, который даёт вашему LLM прямой доступ к актуальной документации Adapty. 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

Warning

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

Используйте документацию в формате обычного текста

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

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

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

Пошаговая инструкция по интеграции

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

Планирование интеграции

Прежде чем писать код, попросите LLM проанализировать ваш проект и составить план реализации. Если ваш AI-инструмент поддерживает режим планирования (например, в 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

Checkpoint

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

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

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

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

Гайды:

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

Checkpoint

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

Гайды:

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

Checkpoint

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

Гайды:

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

Checkpoint

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

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

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

Гайд: Чеклист релиза

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

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

Tip

Checkpoint

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

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

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

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