Android Q 深色模式适配指南

深色模式适配的目标和方法

在MIUI12上推出全局的深色模式，所有系统应用和主流三方应用适配。

要达到的效果：系统切换到深色模式以后，应用也随之切换到深色模式，这是我们这次MIUI适配深色模式要达到的目标，也是我们对每个系统应用的要求。

适配的方法有三种：

1. Android原生的深色主题
2. 全局反色
3. 第三方框架或者应用自己实现深色模式

关于Android Q深色模式

Android Q上提供了两种实现深色模式的方式：深色主题和全局反色。

深色主题即Theme.AppCompat.DayNight或者Theme.MaterialComponents.DayNight。

深色主题是Android官方提供的实现深色模式的一种方法，应用也可以用起其它自己的方法实现深色模式。

深色主题起作用后，将会加载-night目录下的资源，如果没有找到，那么加载默认资源。对于标准控件，如果应用不提供深色模式的资源，系统也会提供一套默认的深色资源（不过比较难看，基本不可用）

全局反色即ForceDark，系统会根据一套算法，计算出每个View属于前台还是后台。对于前台View，会使其变亮，对于后台View，会使其变暗，而不需要开发者提供两套资源。具体的原理可以移步Android Q Force Dark调研

如果一个activity使用了深色模式，那么全局反色对其将不生效。

建议的整体适配步骤

这个只是整体的适配步骤，具体的适配方法看下面两章。

1. 现状评估。
   打开系统的深色模式，看看自己应用中那些页面有没有问题，一般可以分为三类：
   A、适配了深色模式没有问题
   B、没有适配深色模式的
   C、适配了深色模式但是有问题的
2. 全局反色过滤。
   对于所有的A，请务必禁用全局反色，否则全局反色可能会和已有的深色模式效果冲突。
   对于所有的B，可以设置 true ，然后可以打开全局反色，观察有没有问题。没有问题的，那就适配完成了，问题比较大的归为D
3. 全局反色问题分析。
   对于所有的D， 分析问题的原因，是反色本身的问题还是自己应用的导致的，比如布局存在有问题，有图片、webVIew等。如果是反色本身的问题，请反馈给我（未知用户 (xiaochunming) ）。
   其他的看下能不能通过调整布局等最后还是通过全局反色简单解决，剩下统一归为C
4. 重新适配。
   对于C，看看是不是原来的适配方法有问题，有没有必要采用新的适配方法、框架，可不可以采用系统的深色主题等重新适配。
5. 验证。
   打开系统深色模式，重新测试所有页面

比较理想的做法是：

建议采用深色主题和全局反色相结合的方式。

整个应用的主题使用DayNight，设置false。对于已经支持深色主题或者用其他方法实现了深色模式的页面，没必要再支持全局反色，务必禁用。

对于需要使用反色的页面，使用Light主题，设置true。其他页面单独适配。

深色主题的适配

深色主题在Android Q之前就是已经有了的，只不过其在Android Q上得到了加强。

一个activity如果想使用深色主题，让其主题继承于DayNight主题或者让整个应用的主题继承于DayNight主题即可。

不过，上面的做法只适合跟随系统变化的需求，如果有高级的需求，比如应用想要主动切换到深色主题或者不跟随系统变化，而是让用户选择，那么需要这样做：

1. 监听UImode的变化。manifest中 activity 设置属性 android:configChanges="uiMode"，并重写onConfigurationChanged。注意，声明了configChanges系统将不会重建对应的activity，而是回调onConfigurationChanged，
   需要activity自己处理变化的情况
2. 让Activity继承于AppCompatActivity，这样子可以通过AppCompatDelegate.setDefaultNightMode(mode) 设置当前activity的mode，通过AppCompatDelegate.getDefaultNightMode()获取当前设置的mode。
   系统可以选择的mode有四种，具体解释可以看下面第1篇文章。
3. 用户选择夜间模式的时候，保存用户选择的模式到SharedPreferences，调用recreate()重启activity，注意recreate()是重新创建activity，会回调所有生命周期方法。
4. activity启动的时候，取出之前保存的模式，通过AppCompatDelegate.setDefaultNightMode(mode) 进行当前activity的mode
5. 系统UImode发生变化的时候，即onConfigurationChanged时，获取系统当前的UImode，根据应用自身的逻辑判断需不需要改变当前activity的mode，如果需要改变重复第3、4步。

切换到深色模式时，资源应用的顺序：

1. 应用提供的-night资源
2. 应用设置的默认资源（通常是亮色下的资源，也可以是应用主动在深色模式下设置的主题）
3. 系统的默认深色资源
4. 系统默认的亮色资源

所以，凡是应用自己提供资源了的，那就提供两套，要么就全部用系统的默认资源。

如果一个应用没有使用DayNight主题，那么只会变化应用提供的-night深色资源，其他不会变化，系统也不会应用标准控件的默认深色资源。

具体实现，可以参考：

https://segmentfault.com/a/1190000011472198

https://blog.csdn.net/xiaoxiaocaizi123/article/details/90370275

有两种方式，大同小异，相信大家能看得懂。

全局反色的适配

首先来看下全局反色生效前提：

系统端：

1. 开启深色模式

应用端：

1. activity对应的主题是Light的
2. 对应的控件允许全局反色，默认是forceDarkAllowedDefault，这个值由系统属性debug.hwui.force_dark决定，debug.hwui.force_dark又是由全局反色的开关控制，默认是关闭的。

以上几点缺一不可，需要详细说明几点是：

1. 实现了深色主题的activity是不会受全局反色的影响，前面说了，深色主题是DayNight，不属于Light
2. 如果一个控件没有申明forceDarkAllowed，那么forceDark是否生效取决于全局反色是否开启，如果全局反色开启，那么forceDark生效，否则不生效；
   如果一个控件声明了forceDarkAllowed = false，那么无论如何都不会生效；
   如果一个控件声明了forceDarkAllowed = true，那么只要开启深色模式，全局反色就会生效。
3. forceDarkAllowed可以在主题xml中申明，也可以在代码中动态设置，动态设置可以具体到某一个view，后者会覆盖前者。
   遵循覆盖原则，即子View的声明会覆盖父View的声明，activity的会覆盖这个应用的申明。

全局反色的局限：

1. 目前全局反色只是实验性功能，存在很多bug，不可过于依赖，更多可以参考Force Dark目前存在的问题
2. 图片的主题色调计算有时候会出现差错，进而导致图片的反色出错
3. WebView支持不完善

所以如果一个页面存在WebView或者亮色的图片，建议还是使用深色模式进行适配。

如何开启和禁用全局反色：

设置是否支持全局反色有静态和动态两种方法：

静态方式就是对应用或者activity的主题中声明true 或者 false

动态方法是调用View.setForceDarkAllowed(true)或者View.setForceDarkAllowed(false)，对DecorView设置可以对整个窗口起作用

适配全局反色的步骤：

1. compileSdkVersion 设为29， 否则会编译失败，targetSdkVersion 貌似没有要求
2. 对于需要使用forceDark的activity，务必让其实现Light主题，Dark主题、DayNight主题都不会生效
3. 在activity的主题中申明true 或者 在onCreate中，在setContentView之前，调用getWindow().getDecorView().setForceDarkAllowed(allowed);