Capacitor - Использование резервных пейволов

Чтобы поддерживать бесперебойный пользовательский опыт, важно настроить резервные пейволы для флоу, пейволов и онбордингов. Это позволит приложению продолжить работу при частичной или полной потере интернет-соединения.

Если приложение не может обратиться к серверам Adapty:

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

Оно сможет отобразить резервный флоу или пейвол. Онбординги содержат удалённый контент и требуют интернет-соединения для работы.

Прежде чем следовать шагам этого гайда, скачайте файлы резервной конфигурации из Adapty.

Настройка

Android

Добавьте файл резервной конфигурации в своё приложение. Выберите одну из следующих директорий:
- android/app/src/main/assets/
- android/app/src/main/res/raw/

Папка res/raw требует особого формата именования файлов (название должно начинаться с буквы, без заглавных букв, без специальных символов кроме нижнего подчёркивания и без пробелов).

Обновите свойство android константы FileLocation:
- Если файл находится в директории assets, передайте путь к файлу относительно этой директории.
- Если файл находится в директории res/raw, передайте имя файла без расширения.

iOS

Добавьте резервный JSON-файл в бандл проекта: откройте меню File в XCode и выберите пункт Add Files to “YourProjectName”.
Передайте имя конфигурационного файла в свойство ios константы FileLocation.

Пример


const fileLocation = {
  ios: {
    fileName: 'ios_fallback.json'
  },
  android: {
    //if the file is located in 'android/app/src/main/assets/'
    relativeAssetPath: 'android_fallback.json'
  }
};

await adapty.setFallback({ fileLocation });

setFallback должен выполниться до того, как SDK загрузит целевой флоу, пейвол или онбординг.

Параметры:

Parameter	Description
fileLocation	Объект, указывающий местоположение файла резервной конфигурации.