"微信都支持暗黑模式了，咱 App 也适配一波!"

Zhujiang |作者

承香墨影 |校对

https://juejin.im/post/5e95633951882573c2192501 |原文

一、前言

第一次听到暗黑模式的时候，感觉好酷啊，听着就好看（ 也不知道我怎么听出来的 ）。

苹果在前几年就有暗黑模式的风声，好像是在 iOS11、iOS12 的时候就说要推出了，结果愣生生等到了 iOS13 暗黑模式才推出。

iOS13 推出到现在已经大半年了，系统应用没得说，完美适配，三方应用也都陆续支持了暗黑模式，就连微信在前段时间的更新中也实现了暗黑模式，先来欣赏下微信的暗黑模式吧！

二、正文

既然苹果实现了暗黑模式，那么安卓肯定不能落下啊，所以在 Android-10（ Q-API Level 29 ）中支持了暗黑模式，不过官方的叫法为 Dark theme，怎么翻译都行，先来看一下官方对暗黑模式的定义吧：

这里就不逐字翻译了，主要来说一下暗黑模式的好处吧：

• 手机的屏幕目前大部分都已经升级成了 OLED 屏幕（ 当然还有一部分手机还是 LCD 屏幕 ），OLED 屏幕显示黑色的时候不会发光，可以大大减小功耗。

• 提高了弱视用户和对强光敏感的用户的可见性。

• 使任何人在昏暗的环境中都更容易使用设备。

怎样开启暗黑模式就不多说了，手机厂商不同，开启方式不同，各大手机厂商魔改的系统，有时候真的找不到在哪设置，自行百度一下吧。

设置暗黑主题

为了支持 Dark 主题，必须将应用的主题设置为，继承自 DayNight 主题（ res/values/styles.xml ）：

<style name="AppTheme" 
  parent="Theme.AppCompat.DayNight">

还可以使用 MaterialComponents 的深色主题：

https://material.io/develop/android/theming/dark

<style name="AppTheme" 
  parent="Theme.MaterialComponents.DayNight">

这会将应用程序的主主题与系统控制的夜间模式标志相关联，并为应用程序提供默认的深色主题（ 启用时 ）。当系统的主题切换时，应用也会随之切换主题。

“这就完了？”

“对啊，主题就设置完了。”

“那我如果想要自定义主题呢？”

大家日常开发中肯定会有这种需求，官方定义的主题不完全能满足我们的需求，这时候就需要来自定义主题了，谷歌也为我们想到了这一点。

普通模式下咱们不需要动，该怎么写怎么写，然后在 res 下再新建一个 values-night 的文件夹，然后把你自定义的放进去，name 名为 styles.xml 中对应的主题名称就可以了。

来看一下吧：

这样设置完就 OK 了。

“不对啊，这只是主题变了，那我的 Activity 的背景、字体的颜色、图片等等该怎么办呢？”

“别着急，下面就要说了。”

这里一定要注意，主题和样式应避免在浅色主题下使用硬编码的颜色或图标，应该使用主题属性（ 首选 ）或夜间限定的资源。来了解下两个最重要的主题属性吧：

• ?android:attr/textColorPrimary：这是一种通用的文本颜色。浅色主题为近黑色，深色主题为近白。它包含禁用状态。

• ?attr/colorControlNormal：通用图标颜色。它包含禁用状态。

当然肯定不是必须要使用上面官方提供的两个主题属性，想自定义就自定义啊！眼睛尖的可能已经看见了，上面的图片中的 values-night 中除了放有 style.xml 外还有 colors.xml ，对，没错，咱们只要把颜色信息放入到 colors.xml 中然后根据需求写上两个颜色就好了。

但还是建议使用 Material Design Components，因为它的颜色主题系统 （ 例如主题属性 ?attr/colorSurface 和 ?attr/colorOnSurface ）可以轻松访问合适的颜色。

https://material.io/develop/android/

https://material.io/develop/android/theming/color/

“大哥，背景颜色和字体颜色我知道怎么改了，图片呢？图片咋办啊！”

“来了来了，猴急猴急的！”

图片设置其实和颜色差不多，也是两套资源，比如你的 drawable 文件夹下有一张 aaa.jpg 的图片，你想在暗黑模式下换成另外一张图片，那么你就可以新建一个 drawable-night 的文件夹，在里面放上你的另外一张图片就行了，注意， 图片名称一定要和 drawable 中的对应。

同理， drawable-xhdpi 、 drawable-xxhdpi 就是再建两个文件夹： drawable-night-xhdpi 、 drawable-night-xxhdpi ，然后放入对应图片就行了。

“什么？你想看一下效果？那好吧，如你所愿，这真的是你，要是别人我都不让他看。。。。”

怎么样，效果还可以吧？

四、应用内修改主题

“我还想自己主动切换，不想随着系统换才换”

“来，你过来，你还想干啥，说，来来来，说吧”

“我就想自己主动设置是否跟随系统切换主题。。。我看好多应用都有这个功能”

哎，既然你发自内心的问了，那我就大发慈悲的告诉你：当然可以哟！

一般来说应用都会有几个选项供你选择，分别是：普通模式、暗黑模式、跟随系统，对吧？

谷歌也给了我们这几个选项，可以直接进行设置：

• Light - MODE_NIGHT_NO ： https://developer.android.google.cn/reference/androidx/appcompat/app/AppCompatDelegate.html#MODE_NIGHT_NO

• 黑暗 - MODE_NIGHT_YES ： https://developer.android.google.cn/reference/androidx/appcompat/app/AppCompatDelegate.html#MODE_NIGHT_YES

• 由省电模式设定 - MODE_NIGHT_AUTO_BATTERY ： https://developer.android.google.cn/reference/androidx/appcompat/app/AppCompatDelegate.html#MODE_NIGHT_AUTO_BATTERY

• 系统预设 - MODE_NIGHT_FOLLOW_SYSTEM ： https://developer.android.google.cn/reference/androidx/appcompat/app/AppCompatDelegate.html#MODE_NIGHT_FOLLOW_SYSTEM

咱们刚才所说的就是 Light、黑暗和系统预设，省电模式这里就不写， 如果有需求可以进行实验。

切换主题的方法也很简单，直接调用下面方法就行：

AppCompatDelegate.setDefaultNightMode()

就一行代码就行了，参数需要传入上面的四种模式之一。

来吧，那就写一下代码吧，按照上面的要求写三个按钮，分别来实现普通模式、暗黑模式和系统模式吧：

override fun onClick(v: View) {        
  when(v.id){            
    R.id.btnLight ->{                
      setDefaultNightMode(MODE_NIGHT_NO)            
    }            
    R.id.btnDark ->{                
      setDefaultNightMode(MODE_NIGHT_YES)            
    }            
    R.id.btnDefault ->{                
      setDefaultNightMode(MODE_NIGHT_FOLLOW_SYSTEM)            
    }
  }
}

这个代码应该不需要解释了，上面解释的已经够多了。来看一下实现效果吧：

五、配置变更

“大哥，我又想了下，如果有的页面正在播放视频，我想要延迟配置更改该怎么办啊？”

“来，你过来小兄弟，逗着大哥玩呢？这一天天的！”

来吧，有需求就得有实现，谷歌大大已经为我们都想好了，应用可以通过声明每个 Activity 可以处理 uiMode 配置更改来处理 Dark 主题本身的实现： https://developer.android.google.cn/reference/android/content/res/Configuration#uiMode

<activity
  android:name=".MyActivity"    
  android:configChanges="uiMode" />

当 Activity 声明它处理配置更改时， onConfigurationChanged() 将在主题更改时调用其方法。要检查当前主题是什么，应用可以运行如下代码： Activity#onConfigurationChanged(Configuration)

val currentNightMode = configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK
when (currentNightMode) {    
  Configuration.UI_MODE_NIGHT_NO -> {} // 夜间模式未启用，我们正在使用浅色主题    
  Configuration.UI_MODE_NIGHT_YES -> {} // 夜间模式启用，我们使用的是深色主题  
}

六、总结

文章到这里基本结束了，谷歌用行动告诉我们尽量不要硬编码，出来混都是要还的，硬编码一时爽，一直硬编码一直爽，哈哈哈。

文中源码已上传 Github： https://github.com/zhujiang521/Skin

推荐阅读：

高帧屏-120Hz，对我们写 App 有什么影响？

OkHttp 支持 WebSocket，从源码到协议的分析

Git 如何优雅的回退代码？

本文对你有帮助吗？ 留言、转发、点好看 是最大的支持，谢谢！

公众号后台回复成长『 成长 』，将会得到我准备的学习资料。