Android API 21中ImageView背景色无法设置问题求助

我之前在API21设备上也踩过类似的LayerDrawable tint兼容坑，结合你的代码情况，给你几个针对性的解决办法：

1. 先确认传入的是正确的@ColorInt值 #

你的Kotlin调用代码里用了color(R.color.color_primary)，这很可能是问题的根源之一：

• 在不同API级别下，直接调用resources.getColor()的行为有差异，而且如果你的自定义方法要求的是@ColorInt类型，一定要用兼容方法获取颜色值：

// 替换成兼容的颜色获取方式，确保返回正确的颜色int值
val color = ContextCompat.getColor(context, R.color.color_primary)
myCustomiew.setIconBackgroundColor(color)

这样能避免在API21上传入的是资源ID而非实际颜色值的情况。

2. 兼容API21的Drawable tint实现 #

API21-25之间，Drawable.setTint()方法存在兼容性bug，建议改用setColorFilter()替代，同时手动触发视图刷新：
修改你的Java自定义View代码：

import android.graphics.PorterDuff;
import android.os.Build;

public void setIconBackgroundColor(@ColorInt int color) {
    this.tintIconBackgroundLayer(id.innerCircle, color);
}

private void tintIconBackgroundLayer(@IdRes int layerId, @ColorInt int color) {
    Drawable innerCircle = this.iconBackground.findDrawableByLayerId(layerId);
    if (innerCircle != null) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            innerCircle.setTint(color);
        } else {
            // 对API21-25使用setColorFilter替代setTint
            innerCircle.setColorFilter(color, PorterDuff.Mode.SRC_IN);
        }
        // 强制刷新Drawable和父视图，确保颜色变更生效
        innerCircle.invalidateSelf();
        if (this.iconBackground != null) {
            this.iconBackground.invalidateSelf();
        }
    }
}

3. 修复API21上findDrawableByLayerId的bug #

在API21上，LayerDrawable.findDrawableByLayerId()可能无法正确定位到目标图层（属于系统已知bug），可以改用遍历图层的方式来获取Drawable：

private Drawable findLayerById(LayerDrawable layerDrawable, @IdRes int layerId) {
    if (layerDrawable == null) return null;
    // 遍历所有图层查找对应ID
    for (int i = 0; i < layerDrawable.getNumberOfLayers(); i++) {
        Drawable drawable = layerDrawable.getDrawable(i);
        if (drawable != null && drawable.getId() == layerId) {
            return drawable;
        }
    }
    // 新API级别 fallback到原生方法
    return layerDrawable.findDrawableByLayerId(layerId);
}

然后在tintIconBackgroundLayer里替换查找逻辑：

private void tintIconBackgroundLayer(@IdRes int layerId, @ColorInt int color) {
    if (this.iconBackground instanceof LayerDrawable) {
        Drawable innerCircle = findLayerById((LayerDrawable) this.iconBackground, layerId);
        // 后续的颜色设置逻辑和之前一致
        if (innerCircle != null) {
            // ... 颜色设置代码 ...
        }
    }
}

4. 检查VectorDrawable的兼容性 #

如果你的iconBackground是VectorDrawable，需要确保已经开启Vector兼容：
在build.gradle(Module)里添加：

android {
    defaultConfig {
        vectorDrawables.useSupportLibrary = true
    }
}

同时自定义View里的ImageView建议改用AppCompatImageView，保证VectorDrawable在API21上的正确渲染。

按照上面的步骤逐一排查，应该就能解决API21上的背景色设置问题了！

内容的提问来源于stack exchange，提问作者K.Os