Utiliser les paywalls de secours dans un projet React Native pur

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.

Configuration

Android

1. Ajoutez le fichier de configuration de secours à votre application. Choisissez 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 (commence par une lettre, pas de majuscules, pas de caractères spéciaux à l’exception du trait de soulignement, 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, 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. Passez le nom de votre fichier de configuration à la propriété ios de la constante FileLocation.

Exemple

//after v3.8
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);

//Legacy (before v3.8)
const paywallsLocation = {
  ios: {
    fileName: 'ios_fallback.json'
  },
  android: {
    //if the file is located in 'android/app/src/main/assets/'
    relativeAssetPath: 'android_fallback.json'
  }
}
await adapty.setFallbackPaywalls(paywallsLocation);