从AnimateDpAsState源码剖析自定义AnimateXxxAsState动画

2023-09-16 19:27:59

前言

动画是提升Android应用用户体验的关键要素。Compose中提供了丰富的动画API，使开发者可以轻松创建流畅、响应式的动画效果。其中，animateDpAsState和animateValueAsState是两个常用的动画API。本文将着重剖析animateDpAsState的源码，并在此基础上探讨如何通过animateValueAsState实现自定义animateXxxAsState动画API。

深入`animateDpAsState`源码

animateDpAsState用于对尺寸值执行动画。其源码位于androidx.compose.animation.core包中。以下对其源码进行简要分析：

@ExperimentalAnimationApi
@PublishedApi
internal fun <T : Dp> animateDpAsState(
    targetValue: Dp,
    typeConverter: TypeConverter<T, Float>,
    animationSpec: AnimationSpec<Float>
): State<Dp> = AnimateDpAsState(
    animationSpec,
    typeConverter,
    targetValue
)

从源码中可以看出，animateDpAsState接收三个参数：

targetValue：目标尺寸值
typeConverter：类型转换器，用于将尺寸值转换为浮点数
animationSpec：动画规范，定义动画的持续时间、插值器等属性

animateDpAsState通过创建AnimateDpAsState对象来实现动画。AnimateDpAsState是一个状态对象，它包含动画当前值和动画的目标值。动画值通过animationSpec指定的动画规范不断更新。

自定义`animateXxxAsState`动画

受animateDpAsState的启发，我们可以通过animateValueAsState实现自定义animateXxxAsState动画API。animateValueAsState是一个更通用的动画API，它可以对任意类型的对象执行动画。其源码位于androidx.compose.animation.core包中。

@PublishedApi
internal fun <T> animateValueAsState(
    targetValue: T,
    typeConverter: TypeConverter<T, Float>,
    animationSpec: AnimationSpec<Float>
): State<T> = AnimateValueAsState(
    animationSpec,
    typeConverter,
    targetValue
)

animateValueAsState接收三个参数：

targetValue：目标值
typeConverter：类型转换器，用于将值转换为浮点数
animationSpec：动画规范，定义动画的持续时间、插值器等属性

与animateDpAsState类似，animateValueAsState通过创建AnimateValueAsState对象来实现动画。AnimateValueAsState是一个状态对象，它包含动画当前值和动画的目标值。动画值通过animationSpec指定的动画规范不断更新。

我们可以通过组合animateValueAsState和类型转换器来实现自定义animateXxxAsState动画API。以下是一个示例，展示如何实现animateIntAsState动画API：

fun animateIntAsState(
    targetValue: Int,
    animationSpec: AnimationSpec<Float>
): State<Int> {
    val typeConverter = FloatConverter(Int::toFloat, Float::toInt)
    return animateValueAsState(targetValue, typeConverter, animationSpec)
}