Android Button修改background代码后颜色不显示问题

问题描述 #

• 场景：在GridLayout布局中使用Button控件，修改Button的background属性设置背景颜色
• 异常表现：代码层面修改完成并保存后，界面预览、实际运行时均未展示修改后的颜色效果
• 问题截图：

问题复现代码 #

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/goButton"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="161dp"
        android:layout_marginTop="347dp"
        android:layout_marginEnd="156dp"
        android:layout_marginBottom="336dp"
        android:backgroundTint="@android:color/holo_green_light"
        android:padding="40dp"
        android:text="GO"
        android:textSize="60sp"
        android:visibility="invisible"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <TextView
        android:id="@+id/timerTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginTop="16dp"
        android:background="@android:color/holo_orange_light"
        android:padding="10dp"
        android:text="30s"
        android:textSize="40sp"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <TextView
        android:id="@+id/scoreTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="16dp"
        android:layout_marginEnd="16dp"
        android:background="@android:color/holo_blue_bright"
        android:padding="10dp"
        android:text="0/0"
        android:textSize="40sp"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <TextView
        android:id="@+id/sumTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="16dp"
        android:padding="15dp"
        android:text="31+7"
        android:textSize="30dp"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.5"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <androidx.gridlayout.widget.GridLayout
        android:layout_width="373dp"
        android:layout_height="583dp"
        android:layout_marginStart="8dp"
        android:layout_marginTop="75dp"
        android:layout_marginEnd="8dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/timerTextView">

        <Button
            android:id="@+id/button2"
            android:layout_width="340dp"
            android:layout_height="518dp"
            android:background="@android:color/holo_red_light"/* 
                      修改后的颜色未在界面显示 */
            android:backgroundTint="@color/teal_200"
            android:tag="0"
            android:text="14"
            android:textColor="#263238"
            android:textSize="80sp"
            app:layout_column="0"
            app:layout_columnWeight="1"
            app:layout_gravity="fill"
            app:layout_row="0"
            app:layout_rowWeight="1" />
    </androidx.gridlayout.widget.GridLayout>
</androidx.constraintlayout.widget.ConstraintLayout>

问题原因 #

1. 属性优先级冲突：同时配置了android:background和android:backgroundTint属性。Android Material主题下，backgroundTint是背景着色属性，会在原有背景之上叠加指定色调，优先级高于background设置的纯色值，代码中给backgroundTint配置了@color/teal_200，直接覆盖了background设置的红色。
2. XML语法不合法：在Button标签的属性行中间直接使用了Java风格的/* */块注释，XML语法不支持这种注释格式，会导致布局解析异常，干扰属性正常加载。XML注释必须使用<!-- 注释内容 -->格式，且不能写在标签内部的属性定义区间。

修复步骤 #

• 删除Button标签内部非法的/* */格式注释，如需保留注释请移到标签外部，使用XML标准注释格式。
• 删除android:backgroundTint="@color/teal_200"属性，即可正常显示android:background配置的红色。
• 若使用MaterialComponents主题，删除backgroundTint后仍不生效，可在Button属性中添加app:backgroundTint="@null"关闭默认着色，或将控件替换为androidx.appcompat.widget.AppCompatButton。

修复后核心代码示例 #

<Button
    android:id="@+id/button2"
    android:layout_width="340dp"
    android:layout_height="518dp"
    android:background="@android:color/holo_red_light"
    android:tag="0"
    android:text="14"
    android:textColor="#263238"
    android:textSize="80sp"
    app:layout_column="0"
    app:layout_columnWeight="1"
    app:layout_gravity="fill"
    app:layout_row="0"
    app:layout_rowWeight="1" />
<!-- 修改后的红色背景可在预览和运行时正常显示 -->

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