Android animated-vector target 链接矢量图与属性动画的XML

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 类加载——这些细节不报红，只在某个特定机型上静默失效。