一文读懂AdditiveAnimator:彻底解决Android View动画互相覆盖的卡顿难题,项目完整概览

原创2026-10-21 14:47:021,985 阅读

一文读懂AdditiveAnimator:彻底解决Android View动画互相覆盖的卡顿难题,项目完整概览

AdditiveAnimator(开源库 android_additive_animations)是一个面向 Android 的加性动画(Additive Animations)库。它彻底解决了系统 ObjectAnimator 对同一属性做两个动画时"后者覆盖前者"造成的跳变与卡顿难题,让多个动画可以同时叠加、互不干扰地运行在同一个 View 上。通过简洁的 Builder 链式 API,几行代码就能实现手指跟手位移、多 View 交错淡入、弹簧物理动画等流畅效果。

AdditiveAnimator 链式动画效果演示

1. 为什么系统的 View 动画会"互相覆盖"?

先理解痛点。用原生 API 对同一个属性启动两个动画,比如:

view.animate().x(100).start();
view.animate().y(200).start(); // 后者会"接管"动画,前者的运动被截断

ObjectAnimator 对同一属性只允许存在一个进行中的动画,新动画启动时会直接取消旧动画,导致位置跳变、手感生硬。这正是"动画互相覆盖卡顿"的根源。

AdditiveAnimator 的解法:每个动画只记录自己带来的增量(delta),每帧渲染时把所有进行中的增量累加到目标值上。于是两个动画可以同时存活,各自贡献一部分位移,结束后增量才归零——动画自然"叠加"而非"覆盖"。核心累加逻辑见 AdditiveAnimationAccumulator.java。

2. 功能亮点一览

能力 说明 关键 API
属性叠加动画 同一 View 多个动画同时运行 AdditiveAnimator.animate(view)
多目标动画 一次驱动多个 View,支持交错延迟 targets(views, stagger)
链式编排 顺序执行、延迟衔接 then() / thenWithDelay()
动画状态 自动规避竞态,状态不符自动跳过 state()
可见性动画 淡出后自动设为 GONE fadeVisibility()
弹簧物理动画 类似 Compose spring() 曲线 setSpring()
任意对象动画 自定义 Property 即可 AdditiveObjectAnimator

3. 快速上手:3 行代码实现"手指跟手"动画

这是库中展示效果最惊艳的用法——手指划过屏幕,视图平滑跟随:

public boolean onTouch(View v, MotionEvent event) {
    AdditiveAnimator.animate(animatedView, 1000).x(event.getX()).y(event.getY()).start();
    return true;
}

注意这里没有取消任何旧动画:每次触摸都会叠加一个新的目标,运动轨迹连贯流畅,这正是加性动画的核心价值。入口类是 AdditiveAnimator.java。

多目标则无需写循环:

new AdditiveAnimator().setDuration(1000)
                      .targets(myView1, myView2).alpha(0)
                      .start();

4. 链式编排 then() 与交错 stagger:多段动画无缝衔接

then() 表示"上一段结束后再执行下一段",thenWithDelay(ms) 可以插入延迟。加性模型下,即使上一段动画还没结束就启动了下一段,两者也能平滑叠加,而不是互相打断:

AdditiveAnimator 动画延迟衔接效果

给多个 View 设置 stagger 交错延迟后,动画会依次"波浪式"启动,非常适合列表项入场效果,示例见 MultipleViewsAnimationDemoFragment.java:

AdditiveAnimator.animate(Arrays.asList(view1, view2), 50L) // 相隔 50ms 启动
    .translationYBy(50)
    .thenWithDelay(20)
    .translationYBy(-50)
    .start();

5. 动画状态 state():彻底告别竞态条件

快速切换 UI 时,链式动画可能"过期"——例如高亮动画还在排队,视图其实已经取消高亮了。state() 让每段动画绑定一个状态,执行前自动检查当前状态是否匹配,不匹配就静默跳过:

new AdditiveAnimator()
    .targets(normalViews)
    .scale(1f)
    .then()
    .target(highlightedView)
    .state(MyViewState.HIGHLIGHTED) // 仅当仍处于 HIGHLIGHTED 状态才执行
    .start();

状态机制的基类实现见 AnimationState.kt,Demo 中 CustomViewStateAnimation.java 展示了如何定义自定义状态。

基于此还有一行式可见性动画,淡出后自动把 View 置为 GONE,无需手写结束回调:

AdditiveAnimator.animate(view)
    .fadeVisibility(View.GONE)
    .start();

6. 进阶:弹簧物理动画与任意对象属性

新版支持基于物理的弹簧动画(类似 Figma 的 "gentle" 曲线 / Compose 的 spring()),通过 SpringSolver.kt 求解真实的刚度与阻尼参数,setSpring(stiffness, damping) 即可使用。

想动画化任意对象的任意属性(比如自定义绘制的 Canvas 颜色),只需提供 FloatProperty 描述如何读写该属性,然后用 AdditiveObjectAnimator.kt:

FloatProperty<Paint> paintColorProperty =
    FloatProperty.create("PaintColor",
        paint -> (float) paint.getColor(),
        (paint, color) -> paint.setColor((int) color));

AdditiveObjectAnimator.animate(myPaint)
    .property(targetColor, new ColorEvaluator(), paintColorProperty)
    .setAnimationApplier(new ViewAnimationApplier(myView))
    .start();

更完整的自定义绘制示例在 Demo 的 CustomDrawingFragment.java 中。若要扩展新的 View 构建方法,继承 SubclassableAdditiveViewAnimator.java 即可。

7. 项目结构速览

android_additive_animations/
├── additive_animations/          # 核心库
│   └── src/main/java/at/wirecube/additiveanimations/
│       ├── additive_animator/    # AdditiveAnimator、序列编排、动画状态
│       └── helper/               # 弹簧求解、颜色/路径 Evaluator、属性包装器
├── demo/                         # 演示 App(移动、变色、路径、多 View、状态)
└── gif/                          # 效果演示动图

常用工具类:FloatProperty.java(自定义属性)、ColorProperties.java(颜色属性包装)、PathEvaluator.java(沿路径运动,对应 Demo 中的 MoveAlongPath 页面)。

8. 集成与 License

在 build.gradle 中添加依赖即可使用(最新版本 1.9.3):

dependencies {
    compile 'at.wirecube:additive_animations:1.9.3'
}

也可以直接克隆源码使用(README 说明 maven 版本未持续更新,建议 fork 源码):

git clone https://gitcode.com/gh_mirrors/an/android_additive_animations

项目采用 Apache License 2.0 开源许可,可放心用于商业项目。


总结:android_additive_animations 用"增量累加"的加性动画模型,从机制上消灭了 Android 系统动画的覆盖与跳变问题;Builder 式 API、多目标 stagger、动画状态与弹簧物理等能力覆盖了从"手指跟手"到"自定义绘制属性"的绝大多数场景。如果你在项目中被动画互相打断、跳变的问题困扰,这套库值得完整体验一遍。

登录后查看全文
android_additive_animations