Android取消深色适配

news2024/11/16 19:54:49

从Android10（API 29）开始，在原有的主题适配的基础上，Google开始提供了Force Dark机制，在系统底层直接对颜色和图片进行转换处理，原生支持深色模式。当系统设置深色主题背景或者进入省电模式情况下会进入深色主题背景模式，这样就会导致系统页面都是黑色的显得很不美观，进入了深色主题模式，产品要求禁用深色主题模式，所以功能开发需要要求禁用深色主题功能。

我们常见的需要设置的资源有drawable、layout、mipmap和values等，对于这些资源，我们可以用一些限定符来表示提供一些备用资源，例如drawable-xhdpi表示超密度屏幕使用的资源，或者layout-land表示横向状态使用的布局。同样的深色模式可以使用资源的限定符-night来表示在深色模式中使用的资源。如下图所示：
在这里插入图片描述
使用了-night限定符的文件夹里面的资源我们称为night资源，没有使用-night限定符的资源我们称为notnight资源。

其中drawable-night-xhdpi可以放置对应超密度屏幕使用的深色模式的图片，values-night可以声明对应深色模式使用的色值和主题。

只需要在values-night下面的themes.xml文件里加入

<resources xmlns:tools="http://schemas.android.com/tools">
    <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
        ......
        <item name="android:forceDarkAllowed" tools:targetApi="q">false</item>
    </style>
</resources>

拓展：深色模式判断&设置

一、判断当前是否深色模式

Configuration.uiMode 有三种NIGHT的模式：

UI_MODE_NIGHT_NO 表示当前使用的是notnight模式资源。
UI_MODE_NIGHT_YES 表示当前使用的是night模式资源。
UI_MODE_NIGHT_UNDEFINED 表示当前没有设置模式。

可以通过以下的代码来判断当前是否处于深色模式：

/**
 * 判断当前是否深色模式
 *
 * @return 深色模式返回 true，否则返回false
 */
fun isNightMode(): Boolean {
  return when (resources.configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK) {
    Configuration.UI_MODE_NIGHT_YES -> true
    else -> false
  }
}

二、判断当前深色模式场景

通过AppCompatDelegate.getDefaultNightMode()可以获取五种深色模式场景：

MODE_NIGHT_AUTO_BATTERY 低电量模式自动开启深色模式。
MODE_NIGHT_FOLLOW_SYSTEM 跟随系统开启和关闭深色模式（默认）。
MODE_NIGHT_NO 强制使用notnight资源，表示非深色模式。
MODE_NIGHT_YES 强制使用night资源。
MODE_NIGHT_UNSPECIFIED 配合 setLocalNightMode(int)) 使用，表示由Activity通过AppCompactActivity.getDelegate()来单独设置页面的深色模式，不设置全局模式。

深色模式设置可以从三个层级设置，从下到上分别是系统层（System Setting）、Applcation层（Application Setting）以及Activity层（Activity Setting）。底层的设置会覆盖上层的设置，例如系统设置了深色模式，但是Application设置了浅色模式，那么应用会显示浅色主题。

系统层（System Setting）是指系统设置中，根据不同产商的手机，可以在设置->显示中修改系统为深色模式。
Application层（Application Setting）通过AppCompatDelegate.setDefaultNightMode()设置深色模式。
Activity层（Activity Setting）通过getDelegate().setLocalNightMode()设置深色模式。

当深色模式改变时，Activity会重建，如果不希望Activity重建，可以在AndroidManifest.xml中对对应的Activity设置android:configChanges="uiMode"，不过设置之后页面的颜色改变需要Activity在中通过监听onConfigurationChanged来动态改变。

通过AppCompatDelegate.setDefaultNightMode(int)可以设置深色模式，源码如下：

public static void setDefaultNightMode(@NightMode int mode) {
  if (DEBUG) {
    Log.d(TAG, String.format("setDefaultNightMode. New:%d, Current:%d",
                             mode, sDefaultNightMode));
  }
  switch (mode) {
    case MODE_NIGHT_NO:
    case MODE_NIGHT_YES:
    case MODE_NIGHT_FOLLOW_SYSTEM:
    case MODE_NIGHT_AUTO_TIME:
    case MODE_NIGHT_AUTO_BATTERY:
      if (sDefaultNightMode != mode) {
        sDefaultNightMode = mode;
        applyDayNightToActiveDelegates();
      }
      break;
    default:
      Log.d(TAG, "setDefaultNightMode() called with an unknown mode");
      break;
  }
}