0

0

Android Vector Drawable xml 矢量图XML文件绘制详解

畫卷琴夢

畫卷琴夢

发布时间:2026-02-12 11:34:33

|

519人浏览过

|

来源于php中文网

原创

Vector Drawable 的 pathData 必须全小写命令、空格分隔坐标、避免混用符号;viewportWidth/Height 必须设为正整数以定义逻辑画布;API 21以下需启用兼容模式并使用 app:srcCompat;tint 会覆盖 fillColor,多色图标应禁用 tint。

android vector drawable xml 矢量图xml文件绘制详解

Vector Drawable 的 pathData 怎么写才不会报错

Android 的 VectorDrawable 不是 SVG,pathData 语法虽类似但限制多。最常见报错是 android.view.InflateException: Binary XML file line #X: invalid pathData,基本都出在坐标格式或命令大小写上。

实操建议:

  • pathData 中所有命令必须小写(m, l, c, z),大写会直接崩溃
  • 坐标之间用空格或逗号分隔,但不能混用;推荐统一用空格,避免解析歧义
  • 不支持相对坐标缩写(如 h10v-5),必须写全 h 10v -5
  • 路径末尾加 z 很安全,但不是必须;未闭合路径在某些 Android 版本上可能渲染异常(尤其 API 21–23)

示例(合法):pathData="M 0 0 L 100 0 L 100 100 Z";错误写法:pathData="M0,0L100,0L100,100z"(缺空格、逗号混用、z 小写但前面没空格)

为什么 android:viewportWidthandroid:viewportHeight 必须设

这两个属性定义了矢量图的逻辑画布尺寸,不是最终显示大小。不设或设为 0 会导致 RuntimeException: viewportWidth/Height must be > 0,且所有 pathData 坐标都会失效——因为系统无法把路径映射到任何空间。

实操建议:

  • 设为整数,常见值是 2448100,和设计稿的 artboard 尺寸对齐即可
  • viewportWidthviewportHeight 不影响最终缩放,只影响路径坐标的解释比例;比如 M 12 12viewportWidth="24" 下就是中心点
  • 不要试图用它们“适配屏幕”,那是 android:width/android:height 和布局的事

错误现象:图标显示为空白,Logcat 出现 Invalid viewport size —— 八成是这两个值被删了或填了 0。

API 21 以下使用 VectorDrawable 需要哪些兼容处理

原生 VectorDrawable 只支持 API 21+;低于此版本必须靠 AppCompatDelegate.setCompatVectorFromResourcesEnabled(true) + app:srcCompat,否则直接 crash 或静默失败。

飞桨PaddlePaddle
飞桨PaddlePaddle

飞桨PaddlePaddle开发者社区与布道,与社区共同进步

下载

实操建议:

  • ApplicationActivity onCreate() 中调用 AppCompatDelegate.setCompatVectorFromResourcesEnabled(true)(仅需一次)
  • XML 中不能用 android:src,必须用 app:srcCompat="@drawable/ic_heart"(注意命名空间)
  • Gradle 插件 3.0+ 默认开启 vectorDrawables.useSupportLibrary = true,但若手动关过,需确认已开启
  • 动态加载时别用 Context.getDrawable(),改用 AppCompatResources.getDrawable(context, R.drawable.xxx)

典型错误:在 API 19 设备上图标不显示,也没报错——大概率是用了 android:src 或忘了开兼容开关。

android:tintandroid:fillColor 混用时谁生效

android:tint 是 View 级着色,作用于整个 Drawable;android:fillColor 内联属性,只对该路径生效。两者共存时,tint 会覆盖 fillColor,除非 fillColor 设为透明或使用 tintMode 控制混合方式。

实操建议:

  • 单色图标优先用 tint,方便主题切换;多色图标必须用 fillColor 分别设色,且禁用 tint
  • 如果用了 tint 还想保留部分路径原色,把那部分路径的 fillColor 设为 #00000000(全透明),再配合 tintMode="src_atop"
  • tintstrokeColor 无效,描边颜色必须用 android:strokeColor 单独控制

容易忽略的一点:在 StateListDrawable(如 selector)里嵌套 VectorDrawable 时,每个子项的 tint 是独立生效的,别指望父容器统一控制。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1926

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2100

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1120

2024.11.28

android开发三大框架
android开发三大框架

android开发三大框架是XUtil框架、volley框架、ImageLoader框架。本专题为大家提供android开发三大框架相关的各种文章、以及下载和课程。

307

2023.08.14

android是什么系统
android是什么系统

Android是一种功能强大、灵活可定制、应用丰富、多任务处理能力强、兼容性好、网络连接能力强的操作系统。本专题为大家提供android相关的文章、下载、课程内容,供大家免费下载体验。

1787

2023.08.22

android权限限制怎么解开
android权限限制怎么解开

android权限限制可以使用Root权限、第三方权限管理应用程序、ADB命令和Xposed框架解开。详细介绍:1、Root权限,通过获取Root权限,用户可以解锁所有权限,并对系统进行自定义和修改;2、第三方权限管理应用程序,用户可以轻松地控制和管理应用程序的权限;3、ADB命令,用户可以在设备上执行各种操作,包括解锁权限;4、Xposed框架,用户可以在不修改系统文件的情况下修改应用程序的行为和权限。

2075

2023.09.19

android重启应用的方法有哪些
android重启应用的方法有哪些

android重启应用有通过Intent、PendingIntent、系统服务、Runtime等方法。本专题为大家提供Android相关的文章、下载、课程内容,供大家免费下载体验。

278

2023.10.18

Android语音播放功能实现方法
Android语音播放功能实现方法

实现方法有使用MediaPlayer实现、使用SoundPool实现两种。可以根据具体的需求选择适合的方法进行实现。想了解更多语音播放的相关内容,可以阅读本专题下面的文章。

353

2024.03.01

2026春节习俗大全
2026春节习俗大全

本专题整合了2026春节习俗大全,阅读专题下面的文章了解更多详细内容。

189

2026.02.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 16.7万人学习

Java 教程
Java 教程

共578课时 | 63.3万人学习

Uniapp从零开始实现新闻资讯应用
Uniapp从零开始实现新闻资讯应用

共64课时 | 6.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号