Скиллы покрывают интеграцию SDK, создание flow и paywall, проверку перед публикацией, миграцию placement и многое другое. Опишите задачу обычными словами — агент сам выберет нужный скилл.
Следуйте этому рецепту, чтобы отобразить прогресс пользователя в виде Lottie-анимации — например, кольца, которое заполняется по мере накопления дневной серии. Приложение рендерит анимацию как нативный Lottie-вью в кастомном элементе.
Прежде чем начать
Обновите приложение до Adapty Android SDK 4.4 или выше. Более ранние версии SDK отображают резервный контент для каждого кастомного элемента.
Настройте Jetpack Compose в модуле приложения. Анимационный виджет в этом рецепте является composable-компонентом.
Добавьте Lottie для Jetpack Compose в приложение через Gradle из com.airbnb.android:lottie-compose.
Обновите ваше приложение до Adapty Android SDK 4.4 или более поздней версии. Более ранние версии SDK показывают резервный контент для каждого кастомного элемента.
Добавьте Lottie в ваше приложение через Gradle из com.airbnb.android:lottie.
Подготовьте анимацию Lottie в формате .json или скачайте пример streak_ring.json. Приложение воспроизводит анимацию с начала и останавливает её пропорционально прогрессу: например, на середине при 50%. Чтобы корректно отобразить прогресс, анимация должна соответствовать следующим условиям:
На первом кадре прогресс равен нулю, на последнем — 100%.
Равномерная скорость без сглаживания. Если анимация начинается медленно и затем ускоряется, то на середине воспроизведения отобразится менее половины прогресса.
ID: streak_ring. В этом рецепте ID также является именем файла анимации.
Height: Оставьте высоту Fixed по умолчанию. Анимация масштабируется, заполняя пользовательский элемент.
Внутри пользовательского элемента добавьте Image со статичным изображением кольца. Пользователи увидят его в качестве резервного контента, если версия вашего приложения не поддерживает воспроизведение анимации.
2. Добавьте файл анимации в приложение
Поместите файл анимации в src/main/assets — папку assets вашего модуля приложения. Файл должен находиться в корне этой папки, а не во вложенной директории.
Имя файла без .json должно совпадать с ID пользовательского элемента, например streak_ring.json для streak_ring.
3. Создайте анимированный экран
Создайте модель для серии и представление, воспроизводящее анимацию. Приложение обновляет модель при изменении серии. Представление считывает данные из модели, поэтому кольцо отображает текущую серию при открытии экрана:
// 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) заполняет кольцо один раз — от пустого состояния до значения progress. Если в вашем приложении стрик уже хранится в StateFlow, используйте этот StateFlow вместо 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) и playAnimation() заполняют кольцо один раз — от пустого до значения progress. Если в вашем приложении стрик уже хранится в LiveData, используйте эту LiveData вместо StreakStore.
4. Привяжите анимацию к кастомному элементу
В вашем общем резолвере добавьте свойство для модели streak. Затем верните анимационный view для типа lottie_animation и ID streak_ring. Выделенные строки показывают, что нужно добавить или изменить. Если в вашем приложении ещё нет общего резолвера, скопируйте весь код целиком:
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 }}
Если в папке assets нет файла с нужным ID, резолвер возвращает null, и пользователи видят фолбэк. Если ваш резолвер уже возвращает вью для каждого файла анимации, верните это вью вместо null, когда ID не равен streak_ring. Так пользователи по-прежнему будут видеть анимации остальных кастомных элементов 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; }}
Если в папке assets нет файла с нужным ID, резолвер возвращает null и пользователь видит фолбэк. Если ваш резолвер уже возвращает вью для каждого файла анимации, возвращайте это вью вместо null, когда ID не совпадает с streak_ring. Так анимации остальных кастомных элементов lottie_animation по-прежнему будут работать.
Создайте резолвер с моделью серии и установите его как глобальный резолвер приложения. Вызовите AdaptyUI.setCustomElementsResolver один раз — например, при запуске приложения:
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. Протестируйте на устройстве
Flow & Paywall Builder не может выполнять код вашего приложения, поэтому на канвасе отображается только резервный вариант. Чтобы предварительно просмотреть анимацию:
Опубликуйте флоу. Чтобы увидеть последнюю опубликованную версию вместо кэшированной, зарегистрируйте устройство как тестовое.
Запустите сборку приложения с резолвером. Установите значение серии 0 дней, откройте экран и убедитесь, что кольцо остаётся пустым. Повторите с 4 и 7 днями и убедитесь, что кольцо заполняется до каждого значения.
Чтобы протестировать резервный вариант, удалите файл анимации из сборки и откройте экран снова.
Чтобы узнать, почему вместо анимации отображается резервный вариант, следуйте инструкциям в разделе Протестируйте на устройстве руководства для Android.