Capacitor - Utiliser les paywalls de secours

Pour maintenir une expérience utilisateur fluide, il est important de configurer des fallbacks pour vos flows, paywalls et onboardings. Cette précaution étend les capacités de l’application en cas de perte partielle ou totale de la connexion internet.

  • Si l’application ne peut pas accéder aux serveurs Adapty :

    Elle pourra afficher un flow ou un paywall de secours, et accéder à la configuration locale de l’onboarding.

  • Si l’application ne peut pas accéder à internet :

    Elle pourra afficher un flow ou un paywall de secours. Les onboardings incluent du contenu distant et nécessitent une connexion internet pour fonctionner.

Important

Avant de suivre les étapes de ce guide, téléchargez les fichiers de configuration de secours depuis 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/
Note

Le dossier res/raw suit une convention de nommage particulière (le nom doit commencer par une lettre, sans majuscules, sans caractères spéciaux à l’exception du tiret bas, et sans espaces).

  1. Mettez à jour la propriété android de la constante FileLocation :
    • Si le fichier se trouve dans le répertoire assets, indiquez le chemin du fichier relatif à ce répertoire.
    • Si le fichier se trouve dans le répertoire res/raw, indiquez 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. Transmettez 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 });
Important

setFallback doit s’exécuter avant que le SDK récupère le flow, le paywall ou l’onboarding cible.

Paramètres :

ParameterDescription
fileLocationObjet représentant l’emplacement du fichier de configuration de secours.