Mostrar el progreso del usuario con una animación Lottie
Sigue esta receta para mostrar el progreso del usuario como una animación Lottie — por ejemplo, un anillo que se rellena para indicar su racha diaria. Tu app renderiza la animación como una vista Lottie nativa en un elemento personalizado.
Esta receta solo cubre aplicaciones iOS. Las aplicaciones creadas con otros frameworks solo muestran el contenido de respaldo de los elementos personalizados. El soporte para Android y frameworks multiplataforma está próximo.
Antes de empezar
- Actualiza tu app a Adapty iOS SDK 4.4 o posterior. Las versiones anteriores del SDK muestran el contenido de respaldo para cada elemento personalizado.
- Configura tu app para obtener y mostrar flows.
- Añade Lottie a tu app con Swift Package Manager, desde
https://github.com/airbnb/lottie-spm.git. - Prepara una animación Lottie en formato
.json, o descarga el archivo de ejemplostreak_ring.json. La app reproduce la animación desde el principio y la detiene de forma proporcional al progreso; por ejemplo, a la mitad para un 50%. Para mostrar el progreso exacto, la animación necesita:- Sin progreso en su primer fotograma, y progreso completo en su último fotograma.
- Una velocidad constante, sin aceleración. Si la animación empieza lentamente y luego se acelera, mostrará menos de la mitad del progreso a mitad de camino.
1. Añade el elemento personalizado a la pantalla
En el Flow & Paywall Builder, añade un elemento personalizado a la pantalla de un flow y configúralo para la animación:
- Type:
lottie_animation. - ID:
streak_ring. En este ejemplo, el ID es también el nombre del archivo de animación. - Height: Mantén la altura Fixed por defecto. La animación se escala para ajustarse al elemento personalizado.
Dentro del elemento personalizado, añade una Image con una imagen estática del anillo. Los usuarios la verán como respaldo cuando su versión de la app no pueda reproducir la animación.
2. Añade el archivo de animación a tu app
En Xcode, añade el archivo de animación al target de tu app. El nombre del archivo sin .json debe coincidir con el ID del elemento personalizado, por ejemplo, streak_ring.json para streak_ring.
3. Crear la vista de animación
Crea un modelo para la racha y una vista SwiftUI que reproduzca la animación. Tu app actualiza el modelo cuando cambia la racha. La vista lee el modelo, por lo que el anillo muestra la racha actual al abrir la pantalla:
.playing(.fromProgress(0, toProgress: progress, loopMode: .playOnce)) rellena el anillo una vez, desde vacío hasta progress. Si tu app ya mantiene la racha en un ObservableObject, usa ese objeto en lugar de StreakStore.
4. Asociar la animación con el elemento personalizado
En tu resolver global de la app, añade una propiedad para el modelo del streak. Luego añade un caso que devuelva StreakRingView para el Type lottie_animation y el ID streak_ring. Las líneas resaltadas muestran qué añadir. Si tu app aún no tiene un resolver global, copia todo el código:
Coloca el caso streak_ring antes que cualquier otro caso lottie_animation, porque Swift solo ejecuta el primer caso que coincide. Si el bundle de la app no tiene ningún archivo para el ID, el resolver devuelve nil y los usuarios ven el fallback.
Crea el resolver con el modelo de streak y configúralo como el resolver global de la app. Llama a AdaptyUI.setCustomElementsResolver(_:) una sola vez, por ejemplo al arrancar la app:
5. Prueba en un dispositivo
El Flow & Paywall Builder no puede ejecutar el código de tu app, por lo que el lienzo solo muestra el fallback. Para previsualizar la animación:
- Publica el flow. Para ver la última versión publicada en lugar de una en caché, registra el dispositivo como dispositivo de prueba.
- Ejecuta una compilación de tu app que incluya el resolver. Establece la racha en varios valores, como 0, 4 y 7 días. Abre la pantalla para cada valor y comprueba que el anillo se llena hasta ese valor.
Para probar el fallback, elimina el archivo de animación de la compilación y vuelve a abrir la pantalla.
Para descubrir por qué aparece el respaldo en lugar de la animación, sigue las instrucciones de la sección Probar en un dispositivo de la guía de iOS.