Android Studio中Button设置自定义drawable背景不生效仅显示colors文件主色

问题根因 #

你的应用主题继承自Theme.MaterialComponents.*系列，该主题下布局中的<Button>标签会默认被实例化为MaterialButton控件，MaterialButton默认强制套用主题中配置的colorPrimary作为背景色调，直接设置android:background属性会被默认染色逻辑覆盖，因此仅能看到主色purple_500，无法显示自定义drawable的渐变圆角效果。

可行解决方案 #

• 方案1：替换按钮控件类型
  将布局中的<Button>标签替换为<androidx.appcompat.widget.AppCompatButton>，该控件不受MaterialComponents主题的强制背景染色逻辑影响，原有android:background配置可直接生效，示例代码如下：

<androidx.appcompat.widget.AppCompatButton
    android:id="@+id/areabtn"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="Surface Area"
    android:layout_centerInParent="true"
    android:background="@drawable/rounded"
    android:textColor="@color/black"/>

• 方案2：禁用MaterialButton的背景染色
  如果要保留MaterialButton的其他特性，可在按钮标签中添加app:backgroundTint="@null"属性，关闭默认背景染色，注意需要在布局根节点添加命名空间xmlns:app="http://schemas.android.com/apk/res-auto"，示例代码如下：

<Button
    android:id="@+id/areabtn"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="Surface Area"
    android:layout_centerInParent="true"
    android:background="@drawable/rounded"
    app:backgroundTint="@null"
    android:textColor="@color/black"/>

• 方案3：修改全局主题适配
  如果全应用都需要大量自定义按钮背景，可直接修改themes文件中的主题父类，将Theme.MaterialComponents.DayNight.DarkActionBar改为Theme.MaterialComponents.DayNight.DarkActionBar.Bridge，Bridge主题不会将普通Button替换为MaterialButton，所有按钮的背景配置都会按传统逻辑生效，无需逐个修改布局中的按钮代码。

修改完成后清理项目缓存再运行，即可正常显示自定义渐变圆角背景。

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