Анимация текста в Kotlin с помощью Lottie
Динамический текст помогает сделать интерфейс Android-приложения выразительнее: заголовок может плавно появляться, сообщение об ошибке — мягко менять состояние, а экран загрузки — объяснять пользователю происходящее. Для таких задач в Kotlin удобно использовать Lottie — библиотеку, которая воспроизводит векторные анимации, экспортированные из Adobe After Effects через Bodymovin.
Lottie особенно полезна, когда требуется синхронизировать текстовые элементы с иллюстрациями, управлять отдельными кадрами и сохранять качество на разных разрешениях. При этом разработчик должен учитывать формат анимации, жизненный цикл экрана, производительность и ограничения самого JSON-файла.
Как устроена текстовая анимация
Lottie не рисует текст так же, как обычный TextView. Анимация обычно создаётся дизайнером в After Effects, где текстовые слои превращаются в набор векторных объектов, ключевых кадров и параметров трансформации. После экспорта приложение получает JSON-файл, описывающий положение, размер, прозрачность и другие свойства элементов.
Есть два подхода к работе с текстом. В первом надпись является частью Lottie-анимации и воспроизводится как заранее подготовленная графика. Такой вариант подходит для коротких фраз, логотипов и декоративных эффектов. Во втором Lottie отвечает только за движение или фон, а изменяемая надпись остаётся обычным TextView, который можно обновлять непосредственно из Kotlin.
Встроенный текст выглядит эффектнее, но хуже подходит для локализации и динамических данных. Если фраза зависит от ответа сервера, имени пользователя или выбранного языка, лучше вынести её за пределы JSON и анимировать стандартный компонент Android.
Подключение библиотеки и ресурса
Для классического интерфейса на XML зависимость добавляют в файл Gradle модуля:
dependencies {
implementation("com.airbnb.android:lottie:6.4.0")
}
Версию следует проверять по актуальной документации и совместимости с проектом. JSON-анимацию обычно помещают в каталог src/main/res/raw, например welcome_text.json. Затем её можно подключить через LottieAnimationView:
<com.airbnb.lottie.LottieAnimationView
android:id="@+id/textAnimation"
android:layout_width="match_parent"
android:layout_height="220dp"
app:lottie_rawRes="@raw/welcome_text"
app:lottie_autoPlay="false"
app:lottie_loop="false" />
В Kotlin запуск и настройка выглядят так:
binding.textAnimation.apply {
repeatCount = 0
speed = 1.0f
playAnimation()
}
Если файл загружается из сети, потребуется контролировать состояние загрузки и ошибки. Для локальных ресурсов это проще и надёжнее: JSON доступен сразу, не зависит от соединения и может кэшироваться вместе с приложением.
Управление появлением надписи
Для последовательного появления букв часто используют диапазон кадров. Например, дизайнер может подготовить композицию, где первые кадры отвечают за прозрачность, следующие — за масштаб, а финальные — за подчёркивание или свечение. В Kotlin можно запускать отдельные сегменты:
binding.textAnimation.addAnimatorUpdateListener { animation ->
val progress = animation.animatedValue as Float
binding.statusText.alpha = progress
}
binding.textAnimation.setMinAndMaxFrame(0, 45)
binding.textAnimation.playAnimation()
Значения кадров зависят от исходной композиции. Метод setMinAndMaxFrame() удобен для сценариев, когда одна анимация содержит несколько состояний: начало загрузки, успешное завершение и сообщение об ошибке. Также можно использовать setMinAndMaxProgress() с диапазоном от 0f до 1f, если важнее относительный прогресс, а не конкретные кадры.
Для обратной связи после окончания воспроизведения применяется слушатель:
binding.textAnimation.addAnimatorListener(object : Animator.AnimatorListener {
override fun onAnimationEnd(animation: Animator) {
binding.statusText.isVisible = true
}
override fun onAnimationStart(animation: Animator) = Unit
override fun onAnimationCancel(animation: Animator) = Unit
override fun onAnimationRepeat(animation: Animator) = Unit
})
Такой механизм позволяет сначала показать графический эффект, а затем открыть постоянный текст. При переходе между фрагментами анимацию следует останавливать в onStop() или использовать владельца жизненного цикла, чтобы не расходовать ресурсы в фоне.
Текстовые слои и динамические значения
Если надпись должна изменяться во время работы приложения, не стоит заранее создавать отдельную Lottie-композицию для каждого варианта. Проще разместить поверх анимации обычный TextView:
binding.statusText.text = getString(R.string.download_complete)
binding.statusText.animate()
.alpha(1f)
.translationY(0f)
.setDuration(350L)
.start()
Lottie в этом случае может показывать появление карточки, вспышку, стрелку или другой визуальный акцент. Такой вариант хорошо сочетается с локализацией, динамическими данными и доступностью: системные средства чтения экрана смогут корректно обработать содержимое TextView.
Редактируемые текстовые слои Lottie поддерживаются ограниченно и зависят от способа экспорта. В некоторых случаях можно использовать addValueCallback() для изменения цвета или прозрачности слоя, однако замена самого текста требует совместимой структуры композиции. Перед выпуском нужно проверить результат на реальном устройстве, поскольку After Effects поддерживает больше эффектов, чем мобильный рендерер.
Для поиска удачных визуальных решений полезно изучать примеры веб-анимации и обращать внимание на ритм, длительность переходов и контраст текста, а не копировать отдельные эффекты без адаптации к мобильному интерфейсу.
Производительность и качество интерфейса
Большой JSON-файл, сложные маски, размытие и большое количество shape-слоёв могут заметно нагрузить процессор и графический процессор. Текстовая анимация должна оставаться лёгкой: ограничивайте число элементов, удаляйте невидимые слои и не используйте тяжёлые эффекты без необходимости. Для короткого уведомления часто достаточно нескольких десятков кадров при частоте 30 кадров в секунду.
Если анимация запускается неоднократно, полезно включить кэширование:
binding.textAnimation.setCacheComposition(true)
Также стоит выбирать подходящий режим масштабирования. FIT_CENTER сохраняет пропорции, а CENTER_CROP заполняет контейнер с возможной обрезкой краёв. Ошибочный режим может сделать надпись слишком маленькой или исказить композицию на широком экране.
Проверяйте производительность на бюджетных устройствах и в тёмной теме. Контраст, размер шрифта и скорость движения должны оставаться приемлемыми для пользователей с ограничениями зрения. Для некритичных декоративных эффектов можно предусмотреть отключение анимации через настройки приложения или системную настройку уменьшения движения.
Выбор подхода для проекта
Lottie хорошо подходит для выразительных, заранее подготовленных сценариев, но не является универсальной заменой Android-анимациям. Если нужно просто плавно изменить прозрачность, положение или размер текста, стандартные ViewPropertyAnimator, ObjectAnimator или анимации Jetpack Compose будут проще и дешевле.
В Compose используется отдельная интеграция Lottie, например библиотека lottie-compose. Она позволяет загружать композицию и управлять прогрессом через состояние:
val composition by rememberLottieComposition(
LottieCompositionSpec.RawRes(R.raw.welcome_text)
)
LottieAnimation(
composition = composition,
iterations = 1
)
При выборе технологии важно учитывать источник текста, необходимость локализации, сложность графики и частоту повторного запуска. Для системного интерфейса с изменяемыми данными обычно выигрывает комбинация Lottie и стандартных компонентов, а для брендированного экрана приветствия — цельная композиция с текстом внутри JSON.
| Подход | Сильные стороны | Ограничения | Подходящий сценарий |
|---|---|---|---|
| Текст внутри Lottie | Единый визуальный стиль, точная синхронизация | Сложная локализация, большой JSON | Приветствие, логотип, промо-экран |
Lottie плюс TextView |
Динамические данные, доступность, простое изменение строк | Требуется согласовать слои | Статусы, уведомления, загрузка |
ObjectAnimator |
Малый расход ресурсов, полный контроль из Kotlin | Нет сложной графики | Появление, сдвиг и затухание текста |
| Анимации Jetpack Compose | Декларативный код и удобная работа с состоянием | Нужна Compose-инфраструктура | Современные экраны на Compose |
Перед публикацией проверьте, что анимация корректно переживает поворот экрана, повторное открытие фрагмента и смену конфигурации. Отдельно протестируйте отсутствие текста, длинные переводы и медленное устройство. Такой подход помогает сохранить привлекательную подачу, не превращая декоративный эффект в источник задержек и ошибок.