Las skills cubren la integración del SDK, la creación de flows y paywalls, las auditorías previas a la publicación, la migración de placements y mucho más. Describe la tarea en lenguaje natural y tu agente elegirá la skill adecuada.
Sigue esta guía 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.
Antes de empezar
Actualiza tu app al SDK de Adapty para Android 4.4 o posterior. Las versiones anteriores del SDK muestran el contenido de respaldo para cada elemento personalizado.
Configura Jetpack Compose en el módulo de tu app. La vista de animación en esta guía es un composable.
Añade Lottie para Jetpack Compose a tu app con Gradle, desde com.airbnb.android:lottie-compose.
Actualiza tu app al SDK de Adapty para Android 4.4 o posterior. Las versiones anteriores del SDK muestran el contenido de respaldo para cada elemento personalizado.
Añade Lottie a tu app con Gradle, desde com.airbnb.android:lottie.
Prepara una animación Lottie en formato .json, o descarga el ejemplo streak_ring.json. La app reproduce la animación desde el principio y la detiene en proporción al progreso; por ejemplo, a la mitad para un 50%. Para mostrar el progreso exacto, la animación necesita:
Ningún progreso en su primer fotograma y progreso completo en el último.
Una velocidad constante, sin aceleración ni desaceleración. Si la animación empieza despacio y luego acelera, mostrará menos de la mitad del progreso cuando llegue al punto intermedio.
ID: streak_ring. En esta receta, el ID es también el nombre del archivo de animación.
Height: Mantén la altura Fixed predeterminada. 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 fallback cuando la versión de tu app no reproduzca la animación.
2. Añade el archivo de animación a tu app
Coloca el archivo de animación en src/main/assets, la carpeta assets de tu módulo de app. Mantenlo en la raíz de esa carpeta, sin subcarpetas.
El nombre del archivo sin .json debe coincidir con el ID del elemento personalizado; por ejemplo, streak_ring.json para streak_ring.
3. Crea la vista de animación
Crea un modelo para la racha y una vista 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 cuando se abre la pantalla:
// the streak that your app keeps up to dateclass StreakStore { val currentStreak = MutableStateFlow(0) // days in a row}@Composablefun StreakRing(animationFile: String, streakStore: StreakStore) { val composition by rememberLottieComposition(LottieCompositionSpec.Asset(animationFile)) val streak by streakStore.currentStreak.collectAsState() // 7 days fill the ring: from 0 for an empty ring to 1 for a full one val progress = minOf(streak / 7f, 1f) LottieAnimation( composition = composition, modifier = Modifier.fillMaxSize(), // scale the animation to fit the custom element clipSpec = LottieClipSpec.Progress(0f, progress), )}
clipSpec = LottieClipSpec.Progress(0f, progress) llena el anillo una vez, desde vacío hasta progress. Si tu app ya mantiene el streak en un StateFlow, usa ese StateFlow en lugar de StreakStore.
// the streak that your app keeps up to datepublic class StreakStore { public final MutableLiveData<Integer> currentStreak = new MutableLiveData<>(0); // days in a row}public class StreakRingView extends LottieAnimationView { private final StreakStore streakStore; private final Observer<Integer> streakObserver = streak -> { // 7 days fill the ring: from 0 for an empty ring to 1 for a full one float progress = Math.min(streak / 7f, 1f); setMinAndMaxProgress(0f, progress); playAnimation(); }; public StreakRingView(Context context, String animationFile, StreakStore streakStore) { super(context); this.streakStore = streakStore; setAnimation(animationFile); } @Override protected void onAttachedToWindow() { super.onAttachedToWindow(); streakStore.currentStreak.observeForever(streakObserver); } @Override protected void onDetachedFromWindow() { streakStore.currentStreak.removeObserver(streakObserver); super.onDetachedFromWindow(); }}
setMinAndMaxProgress(0f, progress) y playAnimation() rellenan el anillo una vez, desde vacío hasta progress. Si tu app ya tiene la racha en un LiveData, usa ese LiveData en lugar de StreakStore.
4. Asocia la animación con el elemento personalizado
En tu resolver global, añade una propiedad para el modelo de racha. Luego devuelve la vista de animación para el tipo lottie_animation y el ID streak_ring. Las líneas resaltadas muestran qué añadir o cambiar. Si tu app aún no tiene un resolver global, copia el código completo:
class CustomElementsResolver( context: Context, private val streakStore: StreakStore,) : AdaptyCustomElementsResolver { // the animation files in the assets folder, listed once private val animationFiles: Set<String> = try { context.assets.list("").orEmpty().toSet() } catch (e: IOException) { emptySet() // no list of files: every Lottie element shows the fallback } override fun resolve(type: String, id: String): AdaptyCustomElementContent? = when (type) { "lottie_animation" -> { // the ID names the animation file, such as streak_ring.json val file = "$id.json" when { file !in animationFiles -> null // no file for this ID: show the fallback id == "streak_ring" -> AdaptyCustomElementContent.compose { StreakRing(file, streakStore) } // the other animations of your resolver else -> null } } // the other Types of your resolver else -> null }}
Si la carpeta assets no tiene ningún archivo para el ID, el resolver devuelve null y los usuarios ven el fallback. Si tu resolver ya devuelve una vista para cada archivo de animación, devuelve esa vista en lugar de null cuando el ID no sea streak_ring. Así, los usuarios siguen viendo las animaciones de los demás elementos personalizados lottie_animation.
public class CustomElementsResolver implements AdaptyCustomElementsResolver { private final StreakStore streakStore; // the animation files in the assets folder, listed once private final Set<String> animationFiles = new HashSet<>(); public CustomElementsResolver(Context context, StreakStore streakStore) { this.streakStore = streakStore; try { String[] files = context.getAssets().list(""); if (files != null) { animationFiles.addAll(Arrays.asList(files)); } } catch (IOException e) { // no list of files: every Lottie element shows the fallback } } @Override public AdaptyCustomElementContent resolve(String type, String id) { if (type.equals("lottie_animation")) { // the ID names the animation file, such as streak_ring.json String file = id + ".json"; if (!animationFiles.contains(file)) { return null; // no file for this ID: show the fallback } if (id.equals("streak_ring")) { return AdaptyCustomElementContent.view( (context, elementContext) -> new StreakRingView(context, file, streakStore) ); } // the other animations of your resolver return null; } // the other Types of your resolver return null; }}
Si la carpeta assets no tiene ningún archivo para el ID, el resolver devuelve null y los usuarios ven el fallback. Si tu resolver ya devuelve una vista para cada archivo de animación, devuelve esa vista en lugar de null cuando el ID no sea streak_ring. Así, los usuarios siguen viendo las animaciones del resto de elementos personalizados lottie_animation.
Crea el resolver con el modelo de racha y configúralo como resolver global de la app. Llama a AdaptyUI.setCustomElementsResolver una sola vez, por ejemplo al arrancar la app:
class App : Application() { // the streak model that your app updates val streakStore = StreakStore() // keep this instance: a resolver for one flow can reuse it // lazy: the context isn't attached yet while App is constructed val customElementsResolver by lazy { CustomElementsResolver(this, streakStore) } override fun onCreate() { super.onCreate() AdaptyUI.setCustomElementsResolver(customElementsResolver) }}
public class App extends Application { // the streak model that your app updates private final StreakStore streakStore = new StreakStore(); // keep this instance: a resolver for one flow can reuse it private CustomElementsResolver customElementsResolver; @Override public void onCreate() { super.onCreate(); customElementsResolver = new CustomElementsResolver(this, streakStore); AdaptyUI.setCustomElementsResolver(customElementsResolver); } public StreakStore getStreakStore() { return streakStore; } public CustomElementsResolver getCustomElementsResolver() { return customElementsResolver; }}
5. Prueba en un dispositivo
El Flow & Paywall Builder no puede ejecutar el código de tu app, por lo que el canvas solo muestra el respaldo. Para previsualizar la animación:
Ejecuta una compilación de tu app que incluya el resolver. Establece el streak en 0 días, abre la pantalla y verifica que el anillo permanezca vacío. Repite con 4 y 7 días, y verifica que el anillo se llene hasta cada valor.
Para probar el respaldo, elimina el archivo de animación de la compilación y abre la pantalla de nuevo.
Para descubrir por qué aparece el respaldo en lugar de la animación, sigue las instrucciones de la sección Prueba en un dispositivo de la guía de Android.