Android Q 深色模式适配指南
深色模式适配的目标和方法
在MIUI12上推出全局的深色模式，所有系统应用和主流三方应用适配。
要达到的效果：系统切换到深色模式以后，应用也随之切换到深色模式，这是我们这次MIUI适配深色模式要达到的目标，也是我们对每个系统应用的要求。
适配的方法有三种：
- Android原生的深色主题
- 全局反色
- 第三方框架或者应用自己实现深色模式
关于Android Q深色模式
Android Q上提供了两种实现深色模式的方式：深色主题和全局反色。
深色主题即Theme.AppCompat.DayNight或者Theme.MaterialComponents.DayNight。
深色主题是Android官方提供的实现深色模式的一种方法，应用也可以用起其它自己的方法实现深色模式。
深色主题起作用后，将会加载-night目录下的资源，如果没有找到，那么加载默认资源。对于标准控件，如果应用不提供深色模式的资源，系统也会提供一套默认的深色资源（不过比较难看，基本不可用）
全局反色即ForceDark，系统会根据一套算法，计算出每个View属于前台还是后台。对于前台View，会使其变亮，对于后台View，会使其变暗，而不需要开发者提供两套资源。具体的原理可以移步Android Q Force Dark调研
如果一个activity使用了深色模式，那么全局反色对其将不生效。
建议的整体适配步骤
这个只是整体的适配步骤，具体的适配方法看下面两章。
-
现状评估。
打开系统的深色模式，看看自己应用中那些页面有没有问题，一般可以分为三类：
A、适配了深色模式没有问题
B、没有适配深色模式的
C、适配了深色模式但是有问题的 -
全局反色过滤。
对于所有的A，请务必禁用全局反色，否则全局反色可能会和已有的深色模式效果冲突。
对于所有的B，可以设置 <item name="android:forceDarkAllowed">true</item> ，然后可以打开全局反色，观察有没有问题。没有问题的，那就适配完成了，问题比较大的归为D -
全局反色问题分析。
对于所有的D， 分析问题的原因，是反色本身的问题还是自己应用的导致的，比如布局存在有问题，有图片、webVIew等。如果是反色本身的问题，请反馈给我（未知用户 (xiaochunming) ）。
其他的看下能不能通过调整布局等最后还是通过全局反色简单解决，剩下统一归为C -
重新适配。
对于C，看看是不是原来的适配方法有问题，有没有必要采用新的适配方法、框架，可不可以采用系统的深色主题等重新适配。 -
验证。
打开系统深色模式，重新测试所有页面
比较理想的做法是：
建议采用深色主题和全局反色相结合的方式。
整个应用的主题使用DayNight，设置<item name="android:forceDarkAllowed">false</item>。对于已经支持深色主题或者用其他方法实现了深色模式的页面，没必要再支持全局反色，务必禁用。
对于需要使用反色的页面，使用Light主题，设置<item name="android:forceDarkAllowed">true</item>。其他页面单独适配。
深色主题的适配
深色主题在Android Q之前就是已经有了的，只不过其在Android Q上得到了加强。
一个activity如果想使用深色主题，让其主题继承于DayNight主题或者让整个应用的主题继承于DayNight主题即可。
不过，上面的做法只适合跟随系统变化的需求，如果有高级的需求，比如应用想要主动切换到深色主题或者不跟随系统变化，而是让用户选择，那么需要这样做：
- 监听UImode的变化。manifest中 activity 设置属性 android:configChanges="uiMode"，并重写onConfigurationChanged。注意，声明了configChanges系统将不会重建对应的activity，而是回调onConfigurationChanged，
需要activity自己处理变化的情况 - 让Activity继承于AppCompatActivity，这样子可以通过AppCompatDelegate.setDefaultNightMode(mode) 设置当前activity的mode，通过AppCompatDelegate.getDefaultNightMode()获取当前设置的mode。
系统可以选择的mode有四种，具体解释可以看下面第1篇文章。 - 用户选择夜间模式的时候，保存用户选择的模式到SharedPreferences，调用recreate()重启activity，注意recreate()是重新创建activity，会回调所有生命周期方法。
- activity启动的时候，取出之前保存的模式，通过AppCompatDelegate.setDefaultNightMode(mode) 进行当前activity的mode
- 系统UImode发生变化的时候，即onConfigurationChanged时，获取系统当前的UImode，根据应用自身的逻辑判断需不需要改变当前activity的mode，如果需要改变重复第3、4步。
切换到深色模式时，资源应用的顺序：
- 应用提供的-night资源
- 应用设置的默认资源（通常是亮色下的资源，也可以是应用主动在深色模式下设置的主题）
- 系统的默认深色资源
- 系统默认的亮色资源
所以，凡是应用自己提供资源了的，那就提供两套，要么就全部用系统的默认资源。
如果一个应用没有使用DayNight主题，那么只会变化应用提供的-night深色资源，其他不会变化，系统也不会应用标准控件的默认深色资源。
具体实现，可以参考：
https://segmentfault.com/a/1190000011472198
https://blog.csdn.net/xiaoxiaocaizi123/article/details/90370275
有两种方式，大同小异，相信大家能看得懂。
全局反色的适配
首先来看下全局反色生效前提：
系统端：
- 开启深色模式
应用端：
- activity对应的主题是Light的
- 对应的控件允许全局反色，默认是forceDarkAllowedDefault，这个值由系统属性debug.hwui.force_dark决定，debug.hwui.force_dark又是由全局反色的开关控制，默认是关闭的。
以上几点缺一不可，需要详细说明几点是：
- 实现了深色主题的activity是不会受全局反色的影响，前面说了，深色主题是DayNight，不属于Light
- 如果一个控件没有申明forceDarkAllowed，那么forceDark是否生效取决于全局反色是否开启，如果全局反色开启，那么forceDark生效，否则不生效；
如果一个控件声明了forceDarkAllowed = false，那么无论如何都不会生效；
如果一个控件声明了forceDarkAllowed = true，那么只要开启深色模式，全局反色就会生效。 - forceDarkAllowed可以在主题xml中申明，也可以在代码中动态设置，动态设置可以具体到某一个view，后者会覆盖前者。
遵循覆盖原则，即子View的声明会覆盖父View的声明，activity的会覆盖这个应用的申明。
全局反色的局限：
- 目前全局反色只是实验性功能，存在很多bug，不可过于依赖，更多可以参考Force Dark目前存在的问题
- 图片的主题色调计算有时候会出现差错，进而导致图片的反色出错
- WebView支持不完善
所以如果一个页面存在WebView或者亮色的图片，建议还是使用深色模式进行适配。
如何开启和禁用全局反色：
设置是否支持全局反色有静态和动态两种方法：
静态方式就是对应用或者activity的主题中声明<item name="android:forceDarkAllowed">true</item> 或者 <item name="android:forceDarkAllowed">false</item>
动态方法是调用View.setForceDarkAllowed(true)或者View.setForceDarkAllowed(false)，对DecorView设置可以对整个窗口起作用
适配全局反色的步骤：
- compileSdkVersion 设为29， 否则会编译失败，targetSdkVersion 貌似没有要求
- 对于需要使用forceDark的activity，务必让其实现Light主题，Dark主题、DayNight主题都不会生效
- 在activity的主题中申明<item name="android:forceDarkAllowed">true</item> 或者 在onCreate中，在setContentView之前，调用getWindow().getDecorView().setForceDarkAllowed(allowed);
