animated-vector 的 target 必须严格匹配 vector 中 group 或 path 的 android:name,大小写敏感且不可含特殊字符;需显式声明被动画属性(如 android:rotation="0"),api 21+ 支持,低版本需用 compat 类并正确加载。

animated-vector 的 target 必须对应 vector 中的 name
Android 的 animated-vector 本质是“绑定关系”:它不自己画图形,只控制已有 vector 里的路径或组。所以 <target></target> 的 android:name 值,必须和被引用的 vector XML 里某个 <group></group> 或 <path></path> 的 android:name 完全一致(大小写敏感、不可含空格或特殊字符)。
常见错误现象:AnimationDrawable.start() 后无动画、Logcat 出现 Target not found: xxx、甚至直接崩溃(API ≤ 23 时部分机型会静默失败)。
- 确保 vector 文件已放在
res/drawable/下,且未被混淆或误删 -
animated-vector引用的android:drawable是 vector 的资源 ID,不是文件名 - 如果 vector 中用了
<group android:name="g1"></group>,target就得写android:name="g1",不能写成g_1或G1 - AS 的 XML 编辑器不会校验这个匹配关系,只能靠人工核对或运行时观察
target 动画只能作用于 vector 内定义的属性
target 不是万能挂钩点——它只允许动画操作 vector 自身支持的属性,比如 pathData、rotation、scaleX、translateY 等。这些属性必须已在 vector 的 <group></group> 或 <path></path> 标签中显式声明(哪怕值是 0 或默认值),否则动画无法注入。
使用场景:想让箭头旋转 180° 表示展开/收起,或让搜索图标中的线条长度变化模拟“扫描”效果。
-
<group></group>支持:rotation、scaleX、scaleY、translateX、translateY、pivotX、pivotY -
<path></path>支持:pathData(关键!用于 morph 动画)、fillColor、strokeColor、strokeWidth - 如果 vector 里没写
android:rotation="0",就不能对它做rotation动画——即使值为 0 也得显式声明 -
pathData动画要求起点和终点的 path 段数、命令类型(M/L/C/Q 等)、参数个数完全一致,否则运行时报Can't morph from X to Y
兼容性坑:API 21+ 才完整支持,低版本需降级处理
animated-vector 在 API 21(Lollipop)才引入,且早期版本(21–22)对 pathData morph 和嵌套 group 动画的支持不稳定。若目标用户包含 Android 5.0 以下设备,不能只依赖 XML 方案。
性能影响:纯 XML 动画在主线程解析开销小,但复杂 morph(如 50+ 控制点)在低端机上可能掉帧;而 Java/Kotlin 层用 AnimatedVectorDrawableCompat 可控性更强,但需额外初始化成本。
- 必须用
AppCompatResources.getDrawable()或AnimatedVectorDrawableCompat.create()加载,直接Context.getDrawable()在低版本会返回 null - 不要在
onCreate()里就调用start(),确保 drawable 已 attach 到 view(推荐在onStart()或post(Runnable)中触发) - 测试时务必在真机 API 21/22 上验证动画是否卡顿或错位,模拟器容易掩盖问题
调试技巧:用 adb 和 Layout Inspector 直接看 target 绑定状态
当动画不动或行为异常,别只盯着 XML 改来改去。Android 提供了轻量级运行时检查手段。
可给出简短示例:
adb shell dumpsys activity top | grep -A 5 "Drawable"
这能确认当前界面加载的是不是你预期的 animated-vector 资源。更直接的是在 Layout Inspector 中选中目标 View → 查看 Background Drawable → 展开 AnimatedVectorDrawable → 观察 mTargets 数组是否非空、每个 target 的 mName 是否匹配 vector 中的 name。
- 如果
mTargets是空数组,说明target名字写错了,或者 vector 没正确引用 - 如果数组有元素但动画不动,检查对应 target 的
mAnimation字段是否为 null(说明 animator XML 未加载成功) - Layout Inspector 在 Android Studio Bumblebee+ 中默认启用,无需额外插件
真正麻烦的从来不是写几行 XML,而是 name 拼错一个字母、vector 里漏写一个 android:rotation、或者忘了在低版本用 compat 类加载——这些细节不报红,只在某个特定机型上静默失效。









