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

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

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

Навык 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/ в директорию skills вашего инструмента.

Запуск

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

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

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

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

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

Гайды:

Checkpoint

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

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

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

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

Отправьте это в свой 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 после активации, но до получения пейволов — иначе покупки могут атрибутироваться анонимному профилю.

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

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

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

Отправьте это в свой 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. Обратите внимание, что для некоторых ИИ-агентов (например, ChatGPT) потребуется скачать llms.txt и загрузить файл в чат.
llms-full.txt: Вся документация Adapty, объединённая в один файл. Очень большой — используйте только когда нужна полная картина.
Файлы для Kotlin Multiplatform: kmp-llms.txt и kmp-llms-full.txt: Подмножества документации для конкретной платформы, которые позволяют сэкономить токены по сравнению с полным сайтом.