Команды fallbacks

Скачайте резервный файл, который приложение использует при отсутствии связи с Adapty. Это тот же файл, что и загрузка Fallbacks на странице Placements.

adapty fallbacks get

adapty fallbacks get --app <app-id> --platform ios --sdk-version 4.4.0 --output ios_fallback.json
ФлагОбязательныйОписание
--appДаID приложения (UUID)
--platformДаios для App Store или android для Google Play. Приложения macOS и visionOS используют файл ios.
--sdk-versionДаВерсия Adapty SDK, с которой собрано приложение, в формате X.Y.Z. Для Flutter, React Native, Unity, Kotlin Multiplatform и Capacitor укажите версию плагина Adapty.
--outputНетФайл для записи. Родительские директории создаются автоматически. Если не указан, файл выводится в стандартный вывод.

Один файл на стор охватывает все плейсменты приложения. Чтобы выгрузить файлы для обоих сторов, запустите команду дважды — с --platform ios и с --platform android.

Файл содержит только активные плейсменты, поэтому перед скачиванием опубликуйте флоу и активируйте их плейсменты. После изменения плейсмента или обновления SDK скачайте файл заново — это снимок на текущий момент.

Adapty определяет формат файла по значению --sdk-version. SDK принимает только тот формат, под который собран, и при запуске отклоняет любой другой — без ошибки сборки:

--sdk-versionФормат файла
4.4.0 и выше12
4.1.x – 4.3.x11
4.0.x10
3.12.x и выше 3.x9
3.8.x – 3.11.x8
3.4.x – 3.7.x7
3.0.x – 3.3.x6
Ниже 3.05

Плейсменты пейволов присутствуют в каждом формате. Плейсменты флоу — только в файлах для SDK 4.0 и выше.

С флагом --output CLI записывает файл только после успешного завершения загрузки, поэтому при сбое предыдущий файл остаётся нетронутым. Без него стандартный вывод содержит только файл, а все ошибки направляются в стандартный поток ошибок. Обычный редирект > file очищает файл до начала запроса, поэтому используйте --output.

Adapty собирает весь файл перед отправкой ответа — для большого приложения это может занять несколько минут. Команда отправляет один запрос и никогда не повторяет его. Каждое приложение может скачать файл 30 раз в час суммарно по всем токенам; после этого команда завершается с ошибкой rate-limit, которая сообщает, сколько нужно подождать. Скачивайте файл для релизных сборок, а не при каждом коммите.

Код выходаЗначение
0Файл записан
1Файл не удалось записать. Предыдущий файл остался без изменений.
2Недопустимое значение флага
3Нет токена или доступ запрещён
4Ошибка API, включая превышение лимита запросов, или ответ, не являющийся резервным файлом
5Adapty недоступен, не ответил в течение 300 секунд или загрузка прервалась