一文读懂AdditiveAnimator:彻底解决Android View动画互相覆盖的卡顿难题,项目完整概览
一文读懂AdditiveAnimator:彻底解决Android View动画互相覆盖的卡顿难题,项目完整概览
AdditiveAnimator(开源库 android_additive_animations)是一个面向 Android 的加性动画(Additive Animations)库。它彻底解决了系统 ObjectAnimator 对同一属性做两个动画时"后者覆盖前者"造成的跳变与卡顿难题,让多个动画可以同时叠加、互不干扰地运行在同一个 View 上。通过简洁的 Builder 链式 API,几行代码就能实现手指跟手位移、多 View 交错淡入、弹簧物理动画等流畅效果。
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) 可以插入延迟。加性模型下,即使上一段动画还没结束就启动了下一段,两者也能平滑叠加,而不是互相打断:
给多个 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、动画状态与弹簧物理等能力覆盖了从"手指跟手"到"自定义绘制属性"的绝大多数场景。如果你在项目中被动画互相打断、跳变的问题困扰,这套库值得完整体验一遍。

