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

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

Используйте навык интеграции 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/ в директорию навыков вашего инструмента.

Запуск

В своём проекте запустите /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, если ваше приложение на Capacitor поддерживает обе платформы. Это обязательно для работы покупок. Подключить сторы
Скопируйте публичный SDK-ключ: В дашборде Adapty перейдите в App settings → General и найдите раздел API keys. В коде это строка, которую вы передаёте в adapty.activate().
Создайте хотя бы один продукт: В дашборде Adapty перейдите на страницу Products. В коде продукты не указываются напрямую — Adapty передаёт их через пейволы. Добавить продукты
Создайте пейвол и плейсмент: В дашборде Adapty создайте пейвол на странице Paywalls, затем назначьте его на плейсмент на странице Placements. В коде идентификатор плейсмента — это строка, которую вы передаёте в adapty.getPaywall(). Создать пейвол
Настройте уровни доступа: В дашборде 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 Capacitor SDK

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

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

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

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

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

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

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

Спланируйте интеграцию

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

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

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

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

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

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

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

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

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

Checkpoint

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

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

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

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

Гайды:

Checkpoint

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

Гайды:

Read these Adapty docs before writing code:
- https://adapty.io/docs/ru/capacitor-quickstart-manual.md
- https://adapty.io/docs/ru/fetch-paywalls-and-products-capacitor.md
- https://adapty.io/docs/ru/present-remote-config-paywalls-capacitor.md
- https://adapty.io/docs/ru/capacitor-making-purchases.md
- https://adapty.io/docs/ru/capacitor-restore-purchase.md

Checkpoint

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

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

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

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

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

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

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

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

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

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

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

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

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

Read these Adapty docs before writing code:
- https://adapty.io/docs/ru/capacitor-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 в одном файле. Очень большой объём — используйте только когда нужна полная картина.
Capacitor-специфичные capacitor-llms.txt и capacitor-llms-full.txt: Подмножества документации для конкретной платформы, позволяющие сэкономить токены по сравнению с полным сайтом.