使用带渐变矢量图的ShapeableImageView在安卓5/6出现资源找不到异常

该崩溃仅出现在安卓5.0（API 21）~安卓6.0（API 23）系统，根因是这两个版本的原生系统不支持在矢量Drawable内部直接嵌入<gradient>标签实现渐变效果：

• 低版本系统解析矢量图时，会把你用<aapt:attr>嵌入的渐变标签错误当成颜色状态列表（ColorStateList）解析，自然抛出invalid color state list tag gradient的解析异常，最终连锁导致资源找不到的报错。
• 矢量图内置渐变的特性是安卓7.0（API 24）才原生支持的，低版本系统没有对应解析逻辑。

下面按优先级给出可落地的修复方案：

• 方案1：开启AppCompat矢量图兼容支持，成本最低

  1. 首先在你App模块的build.gradle的defaultConfig节点下添加配置：

  defaultConfig {
      // 其他原有配置
      vectorDrawables.useSupportLibrary = true
  }
  

  2. 把XML布局中ShapeableImageView的android:src属性替换为app:srcCompat，同时确保布局根节点已经引入了app命名空间：

  xmlns:app="http://schemas.android.com/apk/res-auto"
  
  <com.google.android.material.imageview.ShapeableImageView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      app:srcCompat="@drawable/ic_unread_msg"
      />
  

  该方案依赖AppCompat库的兼容逻辑自动处理低版本矢量图渐变解析，无需修改原有矢量图代码。

• 方案2：替换资源形式
  如果方案1适配后仍有异常，可以直接修改矢量图：要么把矢量图内部的渐变去掉换成单一纯色填充，要么把该渐变图标导出为对应不同dpi的png图片，放到对应drawable-xxx目录下，低版本系统直接加载png资源不会触发解析异常。

• 方案3：动态实现渐变效果
  如果必须保留矢量图的渐变效果，也可以把渐变逻辑从矢量图中剥离，在代码中动态给ShapeableImageView设置GradientDrawable作为背景/填充，避开系统对矢量图内置渐变的解析逻辑。

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