Android vector矢量图转换 SVG转Vector Drawable XML工具

android studio的vector asset studio对svg支持有限，需手动清理svg（删、拆内联样式、转transform为android属性）、用svg2vectordrawable工具转换，并显式设置width/height、viewport及fillcolor以确保兼容性和着色功能。

android studio 自带的 Vector Asset Studio 转换失败怎么办

很多 SVG 文件用 Android Studio 的 Vector Asset Studio 导入时直接报错或图形错位，根本不是工具不行，而是它对 SVG 的支持非常有限：只认最基础的 <path></path>、<group></group> 和简单 fill/stroke，遇到 <defs></defs>、<use></use>、渐变、滤镜、非整数坐标或嵌套 transform 就会静默丢弃或崩溃。

实操建议：

• 先用浏览器打开 SVG，确认能否正常渲染——不能渲染的，Android 几乎肯定转不了
• 用在线工具如 SVGOMG 点击 Clean up，关掉 Remove hidden elements（否则可能删掉 <defs></defs> 里被引用的内容）
• 手动删掉所有 <style></style> 块，把内联 style="fill:#xxx" 拆成独立 fill="#xxx" 属性
• 把 transform="translate(10.5, 20)" 改成 android:translateX="10.5" android:translateY="20" —— Vector Drawable 不支持复合 transform 字符串

命令行批量转换：使用 svg2vectordrawable 工具

官方没提供 CLI，但社区维护的 svg2vectordrawable（github 上同名项目）是目前最稳定的离线转换器，支持大部分 SVG 1.1 特性，且能输出带 android:tint 和 android:alpha 的可编辑 xml。

常见错误现象：java.lang.NoClassDefFoundError: org/w3c/dom/svg/SVGDocument —— 这是因为它依赖 Batik，而 Android Studio 自带的 JDK 17+ 默认不带 XML Graphics 库。

实操建议：

• 下载带完整依赖的 jar 包（不是仅源码），运行命令：java -jar svg2vectordrawable.jar -i input.svg -o res/drawable/ic_logo.xml
• 若提示 Unsupported element: <lineargradient></lineargradient>，说明该 SVG 用了渐变——Vector Drawable 只支持 <gradient></gradient> 且必须写在 <path></path> 外层，需手动提取并重写
• 转换后检查 android:viewportWidth 和 android:viewportHeight 是否与原始 SVG 的 viewBox 一致，不一致会导致缩放变形

手写 Vector Drawable XML 时最容易漏的三个属性

很多人以为只要 <pathdata></pathdata> 对了就行，结果图标在不同屏幕密度上模糊、偏移或颜色异常，问题往往出在三个默认值上。

使用场景：适配深色模式、动态着色、或需要精确对齐文字的 TextView 复合 drawable。

实操建议：

• 必须显式写 android:width="24dp" 和 android:height="24dp" —— 不写会按 viewport 等比缩放，但 dp 单位丢失，导致高密度屏下糊
• 必须设 android:viewportWidth 和 android:viewportHeight 与原始 SVG 的 viewBox 完全一致（例如 "100.0" "100.0"），否则 pathData 坐标系错乱
• 如果要支持 tint，得给 <path></path> 加 android:fillColor="@android:color/transparent"，再靠父控件的 tint 属性控制颜色；不加这句，tint 无效

gradle 构建时报错 AAPT: error: not well-formed (invalid Token)

这个错误几乎全是 XML 语法问题，但 AAPT 报错位置经常不准，实际根源常在 <pathdata></pathdata> 里的空格、逗号或转义字符。

性能影响：这类错误会让构建卡在 aapt2 阶段，且不会给出具体哪一行，排查成本远高于预防。

实操建议：

• 把 <pathdata></pathdata> 内容粘贴到 regex101，用正则 [^x20-x7Etnr] 扫描不可见字符（尤其是 windows 复制带来的 u200e 零宽空格）
• 确保所有逗号前后**没有空格**（M 10,20 L 30,40 ✅，M 10 , 20 L 30 , 40 ❌）
• 路径末尾不要有多余换行或空格，<pathdata>M10,10Z</pathdata> 比 <pathdata>M10,10Zn</pathdata> 更安全

真正麻烦的从来不是怎么转，而是 SVG 里那些“看起来没问题”的小细节——比如一个没闭合的 <path></path>，在浏览器里自动补全了，Vector Drawable 却直接忽略整条路径。