Команды миграции

Перенесите проект RevenueCat в Adapty: его каталог, а также (по желанию) стор-события и историю транзакций. Adapty выполняет каждую миграцию в виде последовательности шагов и сообщает, какие действия доступны следующими, — поэтому перед каждым действием запускайте status. Полная процедура описана в разделе Миграция с RevenueCat.

Все команды, кроме list, create, use, current и unuse, принимают флаг миграции:

ФлагОбязательныйОписание
-m, --migrationНетID миграции. Если не указан, CLI использует переменную окружения ADAPTY_MIGRATION, затем миграцию, сохранённую командой create или use.

adapty migrations list

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

adapty migrations list

adapty migrations create

Запустить миграцию и сохранить её как текущую.

adapty migrations create --name <app-name>
adapty migrations create --flow <flow> --app <app-id>
ФлагОбязательныйОписание
--nameОдин из --name или --flowНазвание нового приложения Adapty. Запускает миграцию каталога. Нельзя использовать вместе с --flow или --app.
--flowОдин из --name или --flowФлоу для запуска в существующем приложении — в том виде, в котором он отображается в adapty migrations list. Требует --app.
--appС --flowID приложения (UUID)
--no-selectНетСоздать миграцию без сохранения её как текущей

Флоу, доступные для существующего приложения после миграции каталога:

ФлоуОписание
transactionsИмпорт истории транзакций из ежедневного облачного экспорта RevenueCat
transactions_supportИмпорт истории транзакций через поддержку RevenueCat и поддержку Adapty — для тарифных планов RevenueCat без облачного экспорта
apple_eventsПеренаправление уведомлений App Store в Adapty с сохранением их получения в RevenueCat
google_eventsПодписка Adapty на Pub/Sub-топик, который RevenueCat использует для уведомлений Google Play
codeЗамена SDK RevenueCat в кодовой базе приложения с помощью вашего агента
integrationsПоиск инструментов аналитики, атрибуции и рассылок в коде приложения для настройки в Adapty с помощью вашего агента
paywall_designВоссоздание дизайнов пейволов RevenueCat во флоу, созданных при миграции каталога, с помощью вашего агента

adapty migrations use

Сохраняет миграцию как текущую, чтобы остальные команды не требовали флага -m.

adapty migrations use <migration-id>
АргументОписание
migration-idID миграции из adapty migrations list

Перед сохранением CLI проверяет, что у вас есть доступ к этой миграции. Сохранённая миграция привязана к текущему токену и действует во всех терминалах.

adapty migrations current

Показывает текущую миграцию и источник её выбора: переменная окружения ADAPTY_MIGRATION или сохранённое значение.

adapty migrations current

adapty migrations unuse

Очищает сохранённую миграцию. Значение ADAPTY_MIGRATION, заданное в оболочке, остаётся активным до тех пор, пока вы его не сбросите.

adapty migrations unuse

adapty migrations status

Показывает состояние миграции, её проблемы и доступные следующие действия.

adapty migrations status
ФлагОбязательныйОписание
--waitНетОпрашивает сервер до тех пор, пока миграция не изменится, затем возвращает актуальное состояние
--timeoutНетВремя опроса для --wait: от 1 до 600 секунд, по умолчанию 120. Принимает 300, 300s или 5m. Требует --wait.

При использовании --json поля next_actions и available_actions содержат ID каждого действия, читаемые им ресурсы, его input_schema и текст confirm.

Код завершения 0 означает, что запрос выполнен успешно, а не что миграция прошла. Проверьте migration.state в ответе.

Шаги миграции adapty

Показывает чеклист миграции и статус каждого шага.

adapty migrations steps

adapty migrations show

Выводит список доступных ресурсов или просматривает конкретный из них.

adapty migrations show [resource]
АргументОписание
resourceИмя ресурса, например apps, mapping, report или export-config. Не указывайте его, чтобы получить список ресурсов, доступных на текущем шаге.

adapty migrations run

Выполняет действие из adapty migrations status.

adapty migrations run <action-id>
АргументОписание
action-idID действия из next_actions или available_actions в adapty migrations status
ФлагОбязательныйОписание
--inputНетВходные данные для действия в виде JSON-объекта, соответствующего input_schema действия. Без входных данных CLI отправляет {}.
--input-fileНетПуть к файлу с входными данными или - для чтения из stdin. Нельзя использовать вместе с --input.
-y, --yesДля действий с текстом confirmПодтверждает действие после ознакомления с текстом confirm. Интерактивный запрос не используется.
--openНетОткрывает ссылку действия даже при использовании пайпа или --json
--no-browserНетВыводит ссылку действия без открытия браузера

Действия бывают трёх видов:

  • Входные действия отправляют ваши данные в Adapty — например, приложения RevenueCat для миграции или ваши решения по маппингу.
  • Внешние действия открывают страницу в дашборде Adapty — например, чтобы вставить секретный API-ключ RevenueCat. Заполните страницу, затем проверьте status.
  • Действия агента, например migrate_code, — это задачи для вашего агента. Запускайте их из git-репозитория приложения: CLI сохраняет данные миграции в .git/adapty/<migration-id>/ и печатает инструкции для агента. Агент сообщает о результате, повторно запустив действие с флагом --input.

adapty migrations close

Завершите или отмените миграцию. После этого её нельзя будет открыть снова.

adapty migrations close --outcome finish --yes
ФлагОбязательныйОписание
--outcomeДаfinish помечает миграцию как завершённую; cancel — отменяет её
-y, --yesДаПодтвердите закрытие

Что дальше