English 中文TürkçeРусскийEspañol日本語Tiếng Việt

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

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

Автоматическая интеграция · Beta
✦ Skill для интеграции Adapty SDK выполняет всю интеграцию из вашего AI-инструмента одной командой.
Использовать skill

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

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

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

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

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

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

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

  1. Подключите сторы: В дашборде Adapty перейдите в App settings → General. Подключите App Store и Google Play, если ваше приложение на Capacitor поддерживает обе платформы. Это обязательно для работы покупок. Подключить сторы

  2. Скопируйте публичный SDK-ключ: В дашборде Adapty перейдите в App settings → General и найдите раздел API keys. В коде это строка, которую вы передаёте в adapty.activate().

  3. Создайте хотя бы один продукт: В дашборде Adapty перейдите на страницу Products. Ссылаться на продукты напрямую в коде не нужно — Adapty передаёт их через пейволы. Добавить продукты

  4. Создайте пейвол и плейсмент: В дашборде Adapty создайте пейвол на странице Paywalls, затем привяжите его к плейсменту на странице Placements. В коде идентификатор плейсмента — это строка, которую вы передаёте в adapty.getFlow(). Создать пейвол

  5. Настройте уровни доступа: В дашборде Adapty настройте каждый продукт на странице Products. В коде строка проверяется как profile.accessLevels['premium']?.isActive. Уровень доступа premium по умолчанию подходит большинству приложений. Если платящие пользователи получают доступ к разным функциям в зависимости от продукта (например, план basic и план pro), создайте дополнительные уровни доступа до начала разработки.

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

Настройте, когда будете готовы

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

  • A/B-тесты: Настраиваются на странице Placements. Изменения кода не требуются. A/B-тесты
  • Дополнительные пейволы и плейсменты: Добавьте больше вызовов getPaywall с разными идентификаторами плейсментов.
  • Интеграции аналитики: Настраиваются на странице Integrations. Процесс настройки зависит от интеграции. См. интеграции аналитики и интеграции атрибуции.

Загрузите документацию Adapty в свою LLM

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 Capacitor SDK

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

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

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

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

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

Пошаговая реализация

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

Планирование интеграции

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

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

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

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

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

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

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

Это руководство описывает Adapty Capacitor SDK v4 (beta) — API, с которым работает quickstart. v4 — предрелизная версия, поэтому убедитесь, что ваш LLM указывает точную версию (npm install @adapty/capacitor@4.0.0-beta.2), а не устанавливает последнюю стабильную 3.x. См. раздел установки SDK 4.0 и руководство по миграции.

Отправьте это в свой 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 плейсмента, отобразите его и обработайте события покупок. Нужные вам гайды зависят от того, как вы обрабатываете покупки.

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

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

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

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

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

Текстовые индексные файлы документации

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

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