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.
Avant de suivre les étapes de ce guide, téléchargez les fichiers de configuration de secours depuis Adapty.
Configuration
Android
- 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/
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).
- Mettez à jour la propriété
androidde la constanteFileLocation:- 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.
- Si le fichier se trouve dans le répertoire
iOS
- 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”.
- Transmettez le nom de votre fichier de configuration à la propriété
iosde la constanteFileLocation.
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 s’exécuter avant que le SDK récupère le flow, le paywall ou l’onboarding cible.
Paramètres :
| Parameter | Description |
|---|---|
| fileLocation | Objet représentant l’emplacement du fichier de configuration de secours. |