Android进度条颜色无法修改？配置后真机不生效求助

这种编辑器显示正常但真机跑起来不对的情况我碰到过好几次，大概率是样式配置的细节没踩对，或者主题、缓存搞的鬼，咱们一步步来查：

1. 确认styles.xml配置与ProgressBar的关联是否正确 #

先检查你定义的自定义style有没有正确绑定到xml里的ProgressBar上。比如你的style应该是类似这样的：

<style name="CustomProgressBarStyle" parent="@android:style/Widget.ProgressBar.Horizontal">
    <!-- API 21+ 可直接用progressTint指定进度颜色 -->
    <item name="android:progressTint">@color/colorProgressBar</item>
    <!-- 如果是圆形进度条，对应indeterminateTint -->
    <!-- <item name="android:indeterminateTint">@color/colorProgressBar</item> -->
</style>

然后在主Activity的xml中，ProgressBar必须显式引用这个style：

<ProgressBar
    android:id="@+id/progressBar"
    style="@style/CustomProgressBarStyle"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:progress="50"/>

要是只在主题里全局设置，但没给ProgressBar指定style，很可能会被默认主题的样式覆盖。

2. 检查Material Components主题的兼容性 #

如果你用的是Theme.MaterialComponents.*系列主题，ProgressBar的颜色可能会被主题的colorPrimary或colorSecondary接管，这时候直接设置android:progressTint可能不生效。你需要改用app:前缀的属性，或者在style里明确覆盖：

<ProgressBar
    ...
    app:progressTint="@color/colorProgressBar"
    app:trackTint="@color/your_track_gray"/>

这里用app:是因为Material Components扩展了原生控件的属性，优先级更高。

3. 清理缓存&重装应用 #

有时候Android Studio的编译缓存或者真机上的旧安装包会留坑，试试这几步：

• 点击顶部菜单 Build > Clean Project，接着 Build > Rebuild Project
• 点击 File > Invalidate Caches...，选择Invalidate and Restart重启编辑器
• 在真机上完全卸载当前应用，再重新运行安装

4. 低API级别适配（API < 21） #

如果你的minSdkVersion低于21，progressTint属性是不生效的，这时候必须用自定义progressDrawable来实现。比如创建res/drawable/custom_progress_bar.xml：

<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 进度条背景轨道 -->
    <item android:id="@android:id/background">
        <shape>
            <solid android:color="#e5e5e5"/>
            <corners android:radius="4dp"/>
        </shape>
    </item>
    <!-- 进度条颜色 -->
    <item android:id="@android:id/progress">
        <clip>
            <shape>
                <solid android:color="@color/colorProgressBar"/>
                <corners android:radius="4dp"/>
            </shape>
        </clip>
    </item>
</layer-list>

然后在style里引用这个drawable：

<style name="CustomProgressBarStyle" parent="@android:style/Widget.ProgressBar.Horizontal">
    <item name="android:progressDrawable">@drawable/custom_progress_bar</item>
</style>

5. 排查代码是否动态修改颜色 #

最后检查下主Activity的代码，有没有在运行时调用setProgressTintList()之类的方法，覆盖了xml里的配置。比如：

ProgressBar progressBar = findViewById(R.id.progressBar);
// 这种代码会直接覆盖xml设置的颜色
progressBar.setProgressTintList(ColorStateList.valueOf(Color.RED));

按上面的步骤排查，应该能找到问题所在。

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