Capacitor - Use fallback paywalls

To maintain a fluid user experience, it is important to set up fallbacks for your flows, paywalls, and onboardings. This precaution extends the application’s capabilities in case of partial or complete loss of internet connection.

  • If the application cannot access Adapty servers:

    It will be able to display a fallback flow or paywall, and access the local onboarding configuration.

  • If the application cannot access the internet:

    It will be able to display a fallback flow or paywall. Onboardings include remote content and require an internet connection to function.

Before you follow the steps in this guide, download the fallback configuration files from Adapty.

Configuration

Android

  1. Ajoutez le fichier de configuration de secours à votre application. Sélectionnez l’un des répertoires suivants :
    • android/app/src/main/assets/

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

      Remarque : le dossier res/raw suit une convention de nommage particulière (commencer par une lettre, pas de majuscules, pas de caractères spéciaux sauf le tiret bas, et pas d’espaces dans les noms).

  2. Mettez à jour la propriété android de la constante FileLocation :
    • Si le fichier se trouve dans le répertoire assets, passez le chemin du fichier relatif à ce répertoire.
    • Si le fichier se trouve dans le répertoire res/raw, passez le nom du fichier sans l’extension.

iOS

  1. Ajoutez le fichier JSON de secours à votre bundle de projet : ouvrez le menu File dans XCode et sélectionnez l’option Add Files to “YourProjectName”.
  2. Passez le nom de votre fichier de configuration à la propriété ios de la constante FileLocation.

Exemple


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 doit être exécuté avant que le SDK ne récupère le flow, le paywall ou l’onboarding cible.

Paramètres :

ParamètreDescription
fileLocationObjet représentant l’emplacement du fichier de configuration de secours.