
本文介绍如何在不修改资源文件的前提下,通过代码动态为 R.drawable 中的图标着色,并返回可直接使用的着色后 Drawable 对象,兼容 Android 4.0(API 14)及以上版本。
本文介绍如何在不修改资源文件的前提下,通过代码动态为 `r.drawable` 中的图标着色,并返回可直接使用的着色后 drawable 对象,兼容 android 4.0(api 14)及以上版本。
在 Android 开发中,R.drawable.icon_name 返回的是一个资源 ID(int 类型),它本身不携带颜色信息;图标原始颜色由其位图或矢量 XML 文件定义。若需运行时动态改变图标颜色(例如适配主题切换、状态高亮等),不能直接“给 int 上色”,而应将其转换为 Drawable 对象后再应用着色逻辑。
推荐使用 DrawableCompat 配合 setTint() 方法,该方案具备良好的向后兼容性,尤其适用于 VectorDrawable 和支持 tint 的 BitmapDrawable(需启用 tintMode):
// 获取原始 Drawable(自动处理 VectorDrawable 兼容性)
Drawable originalDrawable = AppCompatResources.getDrawable(context, R.drawable.icon_name);
if (originalDrawable == null) {
throw new IllegalArgumentException("Drawable resource not found: " + R.drawable.icon_name);
}
// 包装为可着色的 Drawable(关键步骤,确保兼容 API < 21)
Drawable wrappedDrawable = DrawableCompat.wrap(originalDrawable.mutate());
// 应用单色着色(支持 Color Int,如 Color.RED、ContextCompat.getColor() 等)
DrawableCompat.setTint(wrappedDrawable, ContextCompat.getColor(context, R.color.accent));
// ✅ 此 wrappedDrawable 可直接用于 ImageView.setImageDrawable()、Toolbar.setNavigationIcon() 等⚠️ 重要注意事项:
- 必须调用
.mutate()—— 否则着色会污染同一资源 ID 的其他实例(因 Drawable 默认共享状态); - 若图标为
VectorDrawable(.xml矢量图),确保其根节点未显式设置android:tint属性,否则可能覆盖运行时着色; - 对于 PNG/JPEG 等位图资源,着色效果依赖
PorterDuff.Mode.SRC_IN混合模式,默认生效,但仅对非透明区域有效; - 如需多色着色(如渐变)或复杂滤镜,应改用
ColorMatrixColorFilter或自定义Drawable.Callback,而非setTint()。
总结:R.drawable.xxx 本身不可着色,但通过 AppCompatResources.getDrawable() → DrawableCompat.wrap().mutate() → DrawableCompat.setTint() 三步链式操作,即可安全、高效、兼容地实现运行时图标着色,并获得可复用的 Drawable 实例——这正是现代 Android 开发中推荐的标准实践。


















