告别 getColor(int id)，拥抱 getColorCompat()：跨 API 级别获取颜色的最佳实践

2024-03-21 20:10:00

告别 getColor(int id)，拥抱 getColorCompat()：确保跨 API 级别一致获取颜色

简介

随着 Android 6.0 Marshmallow 的发布，Resources.getColor(int id) 方法已被弃用。这个在获取颜色资源方面备受青睐的方法现在已经成为过去式，取而代之的是功能更强大的 ResourcesCompat.getColor(Resources resources, @ColorRes int id, @Nullable Theme theme) 方法。

为何弃用 getColor(int id)？

Google 弃用 getColor(int id) 方法有几个原因：

API 兼容性问题： 该方法在 API 23 及更高版本中已弃用，如果你的应用针对的是这些版本，就无法再使用它。
主题支持不足： getColor(int id) 方法无法处理在运行时更改的主题，而这在现代 Android 开发中正变得越来越普遍。

认识 getColorCompat()

ResourcesCompat.getColor() 方法是 getColor(int id) 方法的升级版本，它解决了两者共同的问题。它不仅适用于所有 Android API 级别，而且还支持主题更改，为开发人员提供了更灵活和一致的方式来获取颜色资源。

语法：

fun getColor(resources: Resources, @ColorRes id: Int, @Nullable theme: Theme?): Int

参数：

resources： 应用的资源对象
id： 要获取的颜色资源的 ID
theme： 可选主题对象（如果需要的话）

返回：

颜色资源的整数表示

使用 getColorCompat() 的好处

采用 ResourcesCompat.getColor() 方法有许多好处：

API 无关： 它适用于所有 Android API 级别，从而消除了针对不同 API 版本开发时出现的兼容性问题。
主题支持： 它支持在运行时更改主题，允许开发人员在保持应用一致性的同时提供主题化的体验。
更好的错误处理： 它会在主题为 null 或资源不存在的情况下引发异常，提供更清晰的错误处理。

局限性

尽管有它的优势，ResourcesCompat.getColor() 方法也有一些局限性：

需要 Theme 对象： 它需要一个可选的 Theme 对象，这在某些情况下可能不可用。
开销略高： 它比 getColor(int id) 方法略慢，尤其是在频繁调用它的时候。

何时使用 getColorCompat()？

一般来说，建议在以下情况下使用 ResourcesCompat.getColor() 方法：

目标 API 级别为 23 或更高： 如果你针对的是 Android 6.0 Marshmallow 及更高版本，则必须使用 ResourcesCompat.getColor() 方法。
需要主题支持： 如果你需要在运行时更改主题，ResourcesCompat.getColor() 方法是唯一的选择。
想要未来兼容： 为了确保你的应用在未来的 Android 版本中保持兼容性，使用 ResourcesCompat.getColor() 方法是明智之举。