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

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

  • Если приложение не может подключиться к серверам Adapty:

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

  • Если приложение не может подключиться к интернету:

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

Important

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

Настройка

Android

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

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

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

iOS

  1. Добавьте резервный JSON-файл в бандл проекта: откройте меню File в XCode и выберите пункт Add Files to “YourProjectName”.
  2. Передайте имя конфигурационного файла в свойство 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 });
Important

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

Параметры:

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