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

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

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

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

Подход через skill (рекомендуется)

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

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

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

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

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

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

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

Настройте по мере готовности

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

A/B-тесты: настраиваются на странице Placements. Изменения в коде не нужны. A/B-тесты
Дополнительные пейволы и плейсменты: добавьте больше вызовов getPaywall с разными идентификаторами плейсментов.
Интеграции аналитики: настраиваются на странице 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

Несмотря на то что 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 Paywall Builder: вы создаёте пейволы в no-code редакторе Adapty, а SDK отображает их автоматически.
Пейволы, созданные вручную: вы строите собственный интерфейс пейвола в коде, но всё равно используете Adapty для получения продуктов и обработки покупок.
Режим Observer: вы сохраняете существующую инфраструктуру покупок и используете Adapty только для аналитики и интеграций.

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

Установка и настройка 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

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

Checkpoint

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

Гайды:

Обзор Observer mode
Реализация Observer mode
Отправка транзакций в Observer mode Отправьте это своему 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

Checkpoint

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Checkpoint

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

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

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

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

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

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

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: Подмножества документации для конкретной платформы, позволяющие сэкономить токены по сравнению с полным сайтом.