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

Эта страница описывает два способа интеграции Adapty в ваше Flutter-приложение. Воспользуйтесь навыком SDK integration ниже для автоматизированного сквозного процесса или следуйте пошаговому руководству ниже.

Используйте навык SDK integration (бета)

Навык adapty-sdk-integration автоматизирует интеграцию от начала до конца: настройка дашборда, установка SDK, пейвол и проверка на каждом этапе. Пошаговое руководство ниже — резервный вариант, если ваш инструмент не поддерживает формат Claude Skills.

Поддерживаемые инструменты: Claude Code, GitHub Copilot CLI, OpenAI Codex, Gemini CLI.

Установка

Выберите форму для своего инструмента. Полный список — в README навыка.

Claude Code: Выполните claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill, затем claude plugin install adapty-sdk-integration@adapty в терминале.
GitHub Copilot CLI: Выполните gh skill install adaptyteam/adapty-sdk-integration-skill.
Gemini CLI: Выполните gemini skills install https://github.com/adaptyteam/adapty-sdk-integration-skill.
OpenAI Codex или любой другой инструмент: Клонируйте репозиторий и скопируйте plugins/adapty-sdk-integration/skills/adapty-sdk-integration/ в директорию навыков вашего инструмента.

Запуск

В вашем проекте запустите /adapty-sdk-integration. Скилл определит вашу платформу и задаст несколько вопросов по настройке. Затем он проведёт вас через настройку дашборда, установку SDK, пейвол и верификацию — подгружая нужную документацию 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 избавляет от необходимости вручную вставлять ссылки на документацию, порядок реализации важен. Следуйте пошаговому руководству по реализации ниже строго по шагам.

Используйте документацию в виде plain text

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

Checkpoint

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

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

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

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

Гайды:

Включить покупки с помощью пейволов (quickstart)
Получить пейволы Paywall Builder и их конфигурацию
Отобразить пейволы
Обрабатывать события пейвола
Реагировать на действия кнопок Это сообщение предназначено для разработчиков, использующих языковые модели (LLM) при работе с кодом. Оно содержит ссылки на документацию Adapty по Flutter и не требует перевода как технический промпт.

Тем не менее, вот перевод для контекста:

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

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

Гайды:

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

Checkpoint

Ожидается: Ваш пользовательский пейвол отображает продукты, полученные из 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 после активации, но до получения пейволов, чтобы избежать анонимной атрибуции профиля.

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

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

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

Отправьте это своему 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-specific flutter-llms.txt и flutter-llms-full.txt: Подборки для конкретных платформ, которые экономят токены по сравнению с полным сайтом.