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

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

Когда у вас есть все пять, можно приступать к написанию кода. Скажите своему LLM: «Мой публичный SDK-ключ — X, мой ID плейсмента — 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 Kotlin Multiplatform SDK

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

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

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

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

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

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

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

Планируйте интеграцию заранее

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

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

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

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

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

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

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

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

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

Checkpoint

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

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

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

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

Гайды:

Read these Adapty docs before writing code:
- https://adapty.io/docs/ru/kmp-quickstart-paywalls.md
- https://adapty.io/docs/ru/kmp-get-pb-paywalls.md
- https://adapty.io/docs/ru/kmp-present-paywalls.md
- https://adapty.io/docs/ru/kmp-handling-events.md
- https://adapty.io/docs/ru/kmp-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-kmp.md
- https://adapty.io/docs/ru/report-transactions-observer-mode-kmp.md

Checkpoint

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Checkpoint

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

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

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

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

Отправьте это своему 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.

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

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

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