Afficher la progression de l'utilisateur avec une animation Lottie
Suivez cette recette pour afficher la progression de l’utilisateur sous forme d’animation Lottie — par exemple, un anneau qui se remplit pour indiquer sa série quotidienne. Votre application affiche l’animation comme une vue Lottie native dans un élément personnalisé.
Cette recette ne couvre que les applications iOS. Les applications développées avec d’autres frameworks n’affichent que le contenu de secours des éléments personnalisés. La prise en charge d’Android et des frameworks multiplateforme est à venir.
Avant de commencer
- Mettez à jour votre application avec le SDK iOS Adapty 4.4 ou une version ultérieure. Les versions antérieures du SDK affichent le contenu de secours pour chaque élément personnalisé.
- Configurez votre application pour récupérer et afficher les flows.
- Ajoutez Lottie à votre application via Swift Package Manager, depuis
https://github.com/airbnb/lottie-spm.git. - Préparez une animation Lottie au format
.json, ou téléchargez l’exemplestreak_ring.json. L’application joue l’animation depuis le début et la stoppe proportionnellement à la progression — par exemple à mi-chemin pour 50 %. Pour afficher la progression exacte, l’animation doit respecter ces conditions :- Aucune progression sur sa première image, et une progression complète sur sa dernière image.
- Une vitesse constante, sans accélération ni décélération. Si l’animation démarre lentement puis accélère, elle affiche moins de la moitié de la progression à mi-chemin.
1. Ajouter l’élément personnalisé à l’écran
Dans le Flow & Paywall Builder, ajoutez un élément personnalisé à un écran de flow, et configurez-le pour l’animation :
- Type :
lottie_animation. - ID :
streak_ring. Dans cette recette, l’ID est aussi le nom du fichier d’animation. - Height : Conservez la hauteur Fixed par défaut. L’animation se redimensionne pour s’adapter à l’élément personnalisé.
Dans l’élément personnalisé, ajoutez une Image avec une photo fixe de la bague. Les utilisateurs la voient comme contenu de secours lorsque leur version de votre application ne prend pas en charge l’animation.
2. Ajoutez le fichier d’animation à votre application
Dans Xcode, ajoutez le fichier d’animation à votre cible d’application. Le nom du fichier sans .json doit correspondre à l’ID de l’élément personnalisé, par exemple streak_ring.json pour streak_ring.
3. Créer la vue d’animation
Créez un modèle pour la série, et une vue SwiftUI qui joue l’animation. Votre application met à jour le modèle lorsque la série change. La vue lit le modèle, de sorte que l’anneau affiche la série actuelle à l’ouverture de l’écran :
.playing(.fromProgress(0, toProgress: progress, loopMode: .playOnce)) remplit l’anneau une fois, de vide jusqu’à progress. Si votre application gère déjà la série dans un ObservableObject, utilisez cet objet à la place de StreakStore.
4. Associer l’animation à l’élément personnalisé
Dans votre résolveur global, ajoutez une propriété pour le modèle de série. Ensuite, ajoutez un cas qui renvoie StreakRingView pour le Type lottie_animation et l’ID streak_ring. Les lignes surlignées indiquent ce qu’il faut ajouter. Si votre application n’a pas encore de résolveur global, copiez l’intégralité du code :
Placez le cas streak_ring avant tout autre cas lottie_animation, car Swift n’exécute que le premier cas correspondant. Si le bundle de l’app ne contient aucun fichier pour cet ID, le resolver retourne nil et les utilisateurs voient le fallback.
Créez le resolver avec le modèle de streak, puis définissez-le comme resolver global de l’app. Appelez AdaptyUI.setCustomElementsResolver(_:) une seule fois, par exemple au lancement de l’app :
5. Tester sur un appareil
Le Flow & Paywall Builder ne peut pas exécuter le code de votre application, donc son canevas affiche uniquement le paywall de secours. Pour prévisualiser l’animation :
- Publiez le flow. Pour voir la dernière version publiée plutôt qu’une version en cache, enregistrez l’appareil comme appareil de test.
- Lancez un build de votre application qui inclut le resolver. Définissez la série sur quelques valeurs, par exemple 0, 4 et 7 jours. Ouvrez l’écran pour chaque valeur et vérifiez que l’anneau se remplit jusqu’à celle-ci.
Pour tester le paywall de secours, supprimez le fichier d’animation du build et rouvrez l’écran.
Pour savoir pourquoi le paywall de secours s’affiche à la place de l’animation, suivez les instructions de la section Tester sur un appareil du guide iOS.