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

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

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

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

  • Если приложение не имеет доступа к интернету:

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

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

Настройка

Android

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

    • android/app/src/main/res/raw/

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

  2. Обновите свойство 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 });

Параметры:

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