图形兼容防火墙 · 不静默丢弃
共享的 path 可以通过，完整 SVG 不能。
VectorDrawable 只覆盖 SVG 几何与绘制能力的一个严格子集。工具会先识别每项源特性，再输出 XML；遇到转换、渐变、文本或资源引用等无法忠实处理的内容会直接报错，而不是悄悄删掉。
能力防火墙
直接通过path · 纯色 fill/stroke · alpha · evenOdd
PASS转换后通过rect · circle · ellipse · line · polygon/polyline
FORGE TO PATH项目约束API 21/24 目标 · AndroidX · 运行时行为
VERIFY IN APP拒绝转换transform · text · gradient · filter · pattern · mask · CSS · dash
FLATTEN OR REDESIGN坐标约定
1:1
SVG viewBox源文件坐标空间
0 0 100 1002:1
Android viewportpathData 坐标空间
100 × 1003:1
固有 dp 尺寸布局占用大小
24dp × 24dp4:1
宽高比由尺寸与 viewport 比例共同决定
需要人工检查×
非零原点需要先重定位几何坐标
严格模式拒绝几何铸造台
<path>android:pathData直接保留命令流<rect>M H V H Z仅支持直角矩形<circle>两段圆弧命令生成闭合路径<ellipse>两段椭圆弧生成闭合路径<line>M L生成开放路径<polygon>/<polyline>M L … Z / M L …分别闭合或保持开放绘制能力清单
纯色填充
fillColor纯色描边
strokeColor + width填充/描边透明度
独立 alpha 字段evenodd
fillTypeCSS 级联 / currentColor
先解析成受支持的显式颜色
gradient / pattern / filter / mask
当前转换器不映射，需重绘或栅格化
虚线描边
先展开成实际路径
text / image / use
先转轮廓或展开引用
paint server URL
当前不解析资源引用
API 交付护照
21+平台 VectorDrawable 基线
本站严格子集以纯色 path 绘制为核心
24+可选择的目标声明
不会因此解锁本站未实现的 gradient 等映射
< 21平台不原生支持 VectorDrawable
评估 AndroidX 或栅格图回退
构建产物XML 语法可被接受
不等于视觉像素已经一致
往返转换检测
几何共享的 path 命令
EXPECTED视觉绘制受支持的纯色子集
EXPECTED元素类型基础图形会变成 path
CHANGED属性顺序由序列化器决定
CHANGED源码字节不承诺完全相同
CHANGED渲染像素必须在目标尺寸和设备验证
REQUIRED交付 Android Studio
1
把 XML 放入 res/drawable
2
打开 VectorDrawable 预览
3
按目标 minSdk 与 AndroidX 配置构建
4
检查可能生成的栅格回退资源
5
验证浅色、深色与主题资源
6
在真机检查渲染和无障碍用法