Android如何以编程方式为ImageView的Drawable设置ColorStateList色调列表并解决失效问题

• 你定义的ColorStateList逻辑完全没有问题：用在TextView上能正常切换颜色，说明状态匹配规则、色值配置都是正确的。二者生效逻辑的差异是，TextView的文字颜色直接和TextView自身的状态回调绑定，状态变化会实时触发颜色重绘；而ImageView的tint着色是和内部绑定的Drawable状态关联的，状态不同步就会导致tint永远命中默认分支。
• 核心触发原因：原有代码先给ImageView配置了imageTintList，之后再调用setImageResource()设置图片。setImageResource内部在加载新Drawable、替换内部图片引用的时候，会重置已经绑定的tint着色器的状态关联，导致tint和Drawable的动态状态完全脱钩，永远只能匹配默认的非聚焦色值。
• 附加影响因素：从资源ID加载的Drawable默认是共享恒定状态的，在列表复用场景下，这类Drawable副本不会主动接收ImageView传递的焦点、选中类动态状态，进一步导致tint无法匹配聚焦分支。
• 低版本系统兼容问题：API21以下的系统原生不支持imageTintList属性，就算代码逻辑正确，tint也不会生效。

1. 调整代码执行顺序，补上必需的着色模式配置
   先完成Drawable的加载设置，再绑定tint列表，必须显式指定SRC_IN着色模式，否则部分机型会出现着色范围偏移，导致颜色只覆盖Drawable的部分区域：

   itemView.left_icon.apply {
       // 先设置图片资源
       setImageResource(context.getDrawableRes(drawableName))
       // 再配置色调列表
       imageTintList = primaryColorSelector
       imageTintMode = PorterDuff.Mode.SRC_IN
   }
   

2. 替换为可变Drawable实例，解决状态不刷新的问题
   直接通过资源ID加载的Drawable会共享全局恒定状态，不会响应View的动态状态变化，需要手动生成脱离缓存的可变实例：

   itemView.left_icon.apply {
       val drawableRes = context.getDrawableRes(drawableName)
       if (drawableRes != ID_NULL) {
           // 从资源加载Drawable，调用mutate()获取不受缓存约束的可变实例
           val iconDrawable = ContextCompat.getDrawable(context, drawableRes)?.mutate()
           setImageDrawable(iconDrawable)
       }
       imageTintList = primaryColorSelector
       imageTintMode = PorterDuff.Mode.SRC_IN
   }
   

3. 低版本系统兼容处理
   对API21以下的系统，手动通过兼容类给Drawable绑定tint逻辑，替代系统原生的tint能力：

   if (Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) {
       val originalDrawable = drawable ?: return@apply
       // 包装Drawable，绑定兼容版本的tint逻辑
       val tintedDrawable = DrawableCompat.wrap(originalDrawable).mutate()
       DrawableCompat.setTintList(tintedDrawable, primaryColorSelector)
       setImageDrawable(tintedDrawable)
   }
   

4. 基础状态校验
   检查ImageView的焦点响应配置，确保它能真正产生state_focused状态：

   itemView.left_icon.apply {
       isFocusable = true
       isFocusableInTouchMode = true
   }
   

• 配置ColorStateList的时候，一定要把优先级高的状态（聚焦、按压、选中）放在状态数组的靠前位置，默认的空状态数组放在最后。如果空状态放在数组前面，会被优先匹配，导致后面所有的特殊状态分支永远无法生效。
• 不要在列表复用的时候直接用全局缓存的Drawable实例，必须通过mutate()生成可变副本，否则不同item的Drawable状态会互相干扰。

内容的提问来源于stack exchange，提问作者Mehdi Satei