如何用Android animated-vector实现矢量图动画XML？

本文共计900个文字，预计阅读时间需要4分钟。

基本原因通常是AnimatedVectorDrawable没有被正确启动，或者目标VectorDrawable的name和动画定义不匹配。Android不会自动播放animated-vector，必须手动调用start()方法；并且它依赖于底层矢量图中的每个path元素。

• 检查是否在代码中调用了 drawable.start()（不是 invalidate() 或 setAlpha()）
• 确认矢量图 XML 中所有被动画控制的元素都有 android:name="xxx"，比如 <path android:name="arrow_path" ...>
• 确认 animator XML 中 android:target="arrow_path" 和上面 name 严格匹配
• 避免在 app:src 里直接设 animated-vector —— 它不支持 layout 中自动启动，必须用 app:srcCompat + 代码启动

vector drawable 中 group 和 path 的 name 冲突问题

同一个 VectorDrawable 里，android:name 必须全局唯一。如果两个 <group> 都叫 "container"，或一个 <path> 和一个 <group> 同名，animated-vector 在解析时会静默失败，动画不执行，也没有报错日志。

• 命名建议带语义前缀，比如 "ic_arrow_path"、"ic_arrow_group"
• 用 Android Studio 的 “Design” 视图点开矢量图预览，能直观看到每个元素的 name，方便核对
• 不要复用已有矢量图的 name——哪怕只是改个颜色，只要新增了动画目标，就得确保 name 不重复

属性动画 target 只支持有限字段

animated-vector 底层靠 ObjectAnimator 驱动，但只暴露了 VectorDrawable 内部几个可写属性：对 <group> 是 rotation、scaleX、scaleY、translateX、translateY；对 <path> 是 pathData。其他如 fillColor、strokeWidth 理论上能动，但需自定义 PathDataEvaluator 或用 ArgbEvaluator，XML 里不支持直接写。

• 想改颜色？得拆成两个 <path>，用 android:visibility 切换，再动画控制 visibility（需 API 21+）
• 想做形变动画（比如箭头变叉号），必须用 android:toPathData + pathData 动画，且起始/结束 pathData 的指令数、参数顺序必须一致，否则插值出错、路径断裂
• trimPathStart / trimPathEnd 不是原生支持字段，得靠自定义 AnimatedVectorDrawableCompat + 反射或升级到 androidx.core:core-ktx 1.12+ 使用 trimPathStart 扩展

兼容性：API 21 以下必须用 compat 方式

原生 animated-vector 在 API 21（Lollipop）才引入。低于此版本会直接崩溃或静默失效，尤其在 ImageView 中用 app:srcCompat 加载时，若没配好 AppCompatDelegate.setCompatVectorFromResourcesEnabled(true)，连矢量图本体都显示不出来。

• 必须在 Application 或 Activity 的 onCreate() 里提前开启兼容：AppCompatDelegate.setCompatVectorFromResourcesEnabled(true)
• 加载方式统一用 ContextCompat.getDrawable(context, R.drawable.avd_arrow) 或 AppCompatResources.getDrawable(...)，别用 getResources().getDrawable()
• 避免在 android:background 里直接引用 animated-vector —— 背景 drawable 不走 compat 流程，低版本必挂

真正难的不是写 XML，而是 name 对齐、pathData 结构一致性、以及低版本下那一堆兼容开关的时机和位置——漏掉任意一个，动画就卡在“看起来该动，但就是不动”。