Android取消深色适配

从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的模式:

  1. UI_MODE_NIGHT_NO 表示当前使用的是notnight模式资源。
  2. UI_MODE_NIGHT_YES 表示当前使用的是night模式资源。
  3. 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()可以获取五种深色模式场景:

  1. MODE_NIGHT_AUTO_BATTERY 低电量模式自动开启深色模式。
  2. MODE_NIGHT_FOLLOW_SYSTEM 跟随系统开启和关闭深色模式(默认)。
  3. MODE_NIGHT_NO 强制使用notnight资源,表示非深色模式。
  4. MODE_NIGHT_YES 强制使用night资源。
  5. 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;
  }
}

从源码可以看出设置 MODE_NIGHT_UNSPECIFIED 模式是不会生效的。

Tips:注意,深色模式变化会导致Activity重建。

文章参考:https://blog.csdn.net/chuyouyinghe/article/details/125403415

相关推荐

  1. android wifi驱动

    2023-12-14 19:16:04       72 阅读
  2. Android状态栏问题

    2023-12-14 19:16:04       19 阅读
  3. Android 14 应用指南

    2023-12-14 19:16:04       50 阅读

最近更新

  1. docker php8.1+nginx base 镜像 dockerfile 配置

    2023-12-14 19:16:04       94 阅读
  2. Could not load dynamic library ‘cudart64_100.dll‘

    2023-12-14 19:16:04       100 阅读
  3. 在Django里面运行非项目文件

    2023-12-14 19:16:04       82 阅读
  4. Python语言-面向对象

    2023-12-14 19:16:04       91 阅读

热门阅读

  1. 客户端注册账号-服务器-存入数据库..

    2023-12-14 19:16:04       43 阅读
  2. 【算法】【动规】单词拆分

    2023-12-14 19:16:04       60 阅读
  3. RESTful API

    2023-12-14 19:16:04       58 阅读
  4. 线程上下文设计模式

    2023-12-14 19:16:04       54 阅读
  5. Shiro框架权限控制

    2023-12-14 19:16:04       56 阅读
  6. 在ubuntu上rmp打包:准备工作

    2023-12-14 19:16:04       63 阅读
  7. spring事务(3)基于XML的声明式事务

    2023-12-14 19:16:04       60 阅读
  8. 使用opencv将Mat图像resize成检测输入的letterbox类型

    2023-12-14 19:16:04       48 阅读
  9. 2312llvm,编译X86的clang与llvm

    2023-12-14 19:16:04       64 阅读
  10. 云原生之深入解析如何使用Dockerfile定制镜像

    2023-12-14 19:16:04       40 阅读
  11. 【vue】element el-table怎么实现跨页勾选

    2023-12-14 19:16:04       61 阅读
  12. linux中网络解析和网络配置

    2023-12-14 19:16:04       59 阅读
  13. 手撕分布式缓存---HTTP Server搭建

    2023-12-14 19:16:04       65 阅读