深色模式适配

之前Apple叫板微信不支持深色模式就下架，Google从Android Q也新增了暗黑主题，可见系统对深色模式愈发的重视。其实【深色模式】国内有些厂商两年前就已经实现。还有一些做的比较优秀有创意的应用就自带深色模式，用户可以在APP内的设置手动切换当前应用到【夜间模式】。今天就来看看有哪些手段可以实现应用的深色模式。

深色模式Demo：android-DarkTheme

1、系统暗黑主题

Android Q中新增的一种主题叫Dark Theme，注意只在API 29及以上可以使用。官方文档： Docs > Guides Dark theme">Android Developers > Docs > Guides Dark theme。

1.1、DayNight theme

应用如果需要支持暗黑主题，APP的Theme必须要继承自Theme.AppCompat.DayNight主题

<style name="ApplicationTheme" parent="Theme.AppCompat.DayNight" />

当然还可以继承自material Design主题Theme.MaterialComponents.DayNight，前提是build.gradle加入了material依赖，详见MATERIAL DESIGN Dark Theme指导文档。

implementation 'com.google.android.material:material:1.3.0-alpha02'

1.2、三种选项

APP有四种可选主题：Light、Dark、System default、Auto。通过方法AppCompatDelegate.setDefaultNightMode(int )设置，有如下四个值：

//自动
     public static final int MODE_NIGHT_AUTO_TIME = 0;
     
     //使用夜间模式时，始终使用灯光模式，无论何时，都启用{@code notnight}合格资源。
     public static final int MODE_NIGHT_NO = 1;
     
     //使用夜间模式时，始终使用黑暗模式，无论何时，都启用{@code night}合格资源。
     public static final int MODE_NIGHT_YES = 2;
     
     //夜间模式在启用系统的“省电模式”时使用暗模式，否则使用“亮模式”。 此模式可以帮助设备降低功耗，具体取决于设备中的显示技术。
     public static final int MODE_NIGHT_AUTO_BATTERY = 3;

通过AppCompatDelegate类来切换深色模式，并且借助该类来获取当前是否是深色模式。

...
    int mode = getDelegate().getLocalNightMode();
    if (mode == AppCompatDelegate.MODE_NIGHT_YES) {
        getDelegate().setLocalNightMode(AppCompatDelegate.MODE_NIGHT_NO);
    } else {
        getDelegate().setLocalNightMode(AppCompatDelegate.MODE_NIGHT_YES);
    }
    ...

1.3、强制反色：forceDarkAllowed

Android Q提供Force Dark功能，在自定义应用全局主题的时候可以明确开启整个应用深色模式强制反色

<style name="ApplicationTheme" parent="Theme.MaterialComponents.DayNight">
        <item name="android:forceDarkAllowed">true</item>
    </style>

如果不希望系统对某个View进行反色，比如一个ImageView不需要在深色模式下反色，则可以增加这个属性android:forceDarkAllowed：

<ImageView
        android:forceDarkAllowed="false"/>

该属性在declare-styleable中的含义说明：

<!-是否允许将强制深色功能应用于此主题。
	将其设置为false将禁用该主题所应用的所有内容以及使用该主题的任何子视图绘制的内容的自动黑暗功能
	将其设置为true将使该视图自动变暗，但是值'true'不会覆盖其父链中的任何'false'值，也不会防止其任何子级出现任何'false' ->
     <attr name =“ forceDarkAllowed” format =“ boolean” />

2、night目录资源适配

前面Android系统自动对View、颜色反色效果其实并不太好。这时候就需要专门为深色模式提供一套资源，当系统切换到黑暗模式的时候就会从这里拿资源（strings、colors、drawable等）。举个例子，可以新建一下几个文件夹，深色模式系统会从对应的深色模式资源文件夹中显示图片、对应的颜色。name要和普通的资源文件夹中的一样。

①values-night/

②drawable-night/

这种方式最简单，效果最好。但是有些资源需要两套，会导致APK的体积变大。

3、应用内深色模式

应用内设置【夜间模式】可以通过切换全局应用主题完成的，定义正常的主题，在定义一个夜间模式的主题(主要颜色、控件等都单独一套_night)。设置中开启【夜间模式】就切换应用主题。

<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
        <item name="colorPrimary">@color/colorPrimary</item>
        <item name="colorPrimaryDark">@android:color/holo_red_dark</item>
        <item name="colorAccent">@color/colorAccent</item>
    </style>
    
    <style name="AppTheme.Night" parent="Theme.AppCompat.Light.NoActionBar">
        <item name="colorPrimary">@color/colorPrimaryNight</item>
        <item name="colorPrimaryDark">@color/color/colorPrimaryDarkNight</item>
        <item name="colorAccent">@color/colorAccentNight</item>
    </style>