Android 10适配要点，深色主题

Android 10.0及以上系统的手机，都可以在Settings -> Display -> Dark theme中对深色主题进行开启和关闭。开启深色主题后，系统的界面风格包括一些内置的应用程序都会变成深色主题的色调，如下图所示。

不过，如果这时你打开我们自己编写的应用程序，你会发现目前界面的风格还是使用的浅色主题模式，这就和系统的主题风格不同了，说明我们需要对此进行适配。

这里我准备使用在第12章中编写的MaterialTest项目来作为示例，看看如何才能让它更加完美地适配深色主题模式。（示例下载地址见链接随书下载部分 https://www.ituring.com.cn/book/2744）。

首先看一下MaterialTest项目的初始运行效果。

接下来我们开始学习如何深色主题模式进行适配。

最简单的一种适配方式就是使用Force Dark，它是一种能让应用程序快速适配深色主题，并且几乎不用编写额外代码的方式。Force Dark的工作原理是系统会分析浅色主题应用下的每一层View，并且在这些View绘制到屏幕之前，自动将它们的颜色转换成更加适合深色主题的颜色。注意，只有原本使用浅色主题的应用才能使用这种方式，如果你的应用原本使用的就是深色主题，Force Dark将不会起作用。

这里我们尝试对MaterialTest项目使用Force Dark转换来进行举例。启用Force Dark功能需要借助android:forceDarkAllowed属性，不过这个属性是从API 29，也就是Android 10.0系统开始才有的，之前的系统无法指定这个属性。因此，我们得进行一些系统差异型编程才行。

右击res目录 -> New -> Directory，创建一个values-v29目录，然后右击values-v29目录 -> New -> Values resource file，创建一个styles.xml文件。接着对这个文件进行编写，代码如下所示：

<item name="colorPrimary">@color/colorPrimary</item>

<item name="colorPrimaryDark">@color/colorPrimaryDark</item>

<item name="colorAccent">@color/colorAccent</item>

</style>

</resources>

除了android:forceDarkAllowed属性之外，其他的内容都是从之前的styles.xml文件中复制过来的。这里给AppTheme主题增加了android:forceDarkAllowed属性并设置为true，说明现在我们是允许系统使用Force Dark将应用强制转换成深色主题的。另外，values-v29目录是只有Android 10.0及以上的系统才会去读取的，因此这是一种系统差异型编程的实现方式。

现在重新运行MaterialTest项目，效果如下图所示。

可以看到，虽然整体的界面风格好像确实变成了深色主题的模式，可是却并不怎么美观，尤其是卡片式布局的效果，经过Force Dark之后已经完全看不出来了。

Force Dark就是这样一种简单粗暴的转换方式，并且它的转换效果通常是不尽如人意的。因此，这里我并不推荐你使用这种自动化的方式来实现深色主题，而是应该使用更加传统的实现方式——手动实现。

是的，要想实现最佳的深色主题效果，不要指望有什么神奇魔法能够一键完成，而是应该针对每一个界面都进行浅色和深色两种主题的界面设计。这听上去好像有点复杂，不过我们仍然有一些好用的技巧能让这个过程变得简单。

在第12章中我们曾经学习过，AppCompat库内置的主题恰好主要分为浅色主题和深色主题两类，比如MaterialTest项目中目前使用的Theme.AppCompat.Light.NoActionBar就是浅色主题，而Theme.AppCompat.NoActionBar就是深色主题。选用不同的主题，在控件的默认颜色等方面会有完全不同的效果。

下面我们动手来尝试一下吧。首先删除values-v29目录及其目录下的内容，然后修改values/styles.xml中的代码，如下所示：

<item name="colorPrimary">@color/colorPrimary</item>

<item name="colorPrimaryDark">@color/colorPrimaryDark</item>

<item name="colorAccent">@color/colorAccent</item>

</style>

…

</resources>

可以看到，这里我们将AppTheme的parent主题指定成了Theme.AppCompat.DayNight.NoActionBar ，这是一种DayNight主题。因此，在普通情况下MaterialTest项目仍然会使用浅色主题，和之前并没有什么区别，但是一旦用户在系统设置中开启了深色主题，MaterialTest项目就会自动使用相应的深色主题。

现在我们就可以重新运行一下程序，看看使用DayNight主题之后，MaterialTest项目默认的界面效果是什么样的，如下图所示。

很明显，现在的界面比之前使用Force Dark转换后的界面要好看很多，至少卡片式布局的效果得到了保留。

然而，虽然现在界面中的主要内容都已经自动切换成了深色主题，但是你会发现标题栏和悬浮按钮仍然保持着和浅色主题时一样的颜色。这是因为标题栏以及悬浮按钮使用的是我们定义在colors.xml中的几种颜色值，代码如下所示：

</resources>

这种指定颜色值引用的方式相当于对控件的颜色进行了硬编码，DayNight主题是不能对这些颜色进行动态转换的。

好在解决方案也并不复杂，我们只需要进行一些主题差异型编程就可以了。右击res目录 -> New -> Directory，创建一个values-night目录，然后右击values-night目录 -> New -> Values resource file，创建一个colors.xml文件。接着在这个文件中指定深色主题下的颜色值，如下所示：

</resources>

这样的话，在普通情况下，系统仍然会读取values/colors.xml文件中的颜色值，而一旦用户开启了深色主题，系统就会去读取values-night/colors.xml文件中的颜色值了。

现在重新运行一下程序，效果如下图所示。

这种深色主题的效果，在夜间使用的时候明显会好上很多，对不对？

虽说使用主题差异型的编程方式几乎可以帮你解决所有的适配问题，但是在DayNight主题下，我们最好还是尽量减少通过硬编码的方式来指定控件的颜色，而是应该更多地使用能够根据当前主题自动切换颜色的主题属性。比如说黑色的文字通常应该衬托在白色的背景下，反之白色的文字通常应该衬托在黑色的背景下，那么此时我们就可以使用主题属性来指定背景以及文字的颜色，示例写法如下：

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:background="?android:attr/colorBackground">

<TextView

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_gravity="center"

android:text="Hello world"

android:textSize="40sp"

android:textColor="?android:attr/textColorPrimary" />

</FrameLayout>

这些主题属性会自动根据系统当前的主题模式选择最合适的颜色值呈现给用户，效果如下图所示。

另外，或许你还会有一些特殊的需求，比如要在浅色主题和深色主题下分别执行不同的代码逻辑。对此Android也是支持的，你可以使用如下代码在任何时候判断当前系统是否是深色主题：

fun isDarkTheme(context: Context): Boolean {

val flag = context.resources.configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK

return flag == Configuration.UI_MODE_NIGHT_YES

}

调用isDarkTheme()方法，判断当前系统是浅色主题还是深色主题，然后根据返回值执行不同的代码逻辑即可。

由于Kotlin取消了按位运算符的写法，改成了使用英文关键字，因此上述代码中的and关键字其实就对应了Java中的&运算符，而Kotlin中的or关键字对应了Java中的|运算符，xor关键字对应了Java中的^运算符，非常好理解。

我个人认为，在绝大多数情况下，让应用程序跟随系统的设置来决定使用浅色主题还是深色主题是最合适的一种做法。然而如果你一定想要脱离系统设置，让自己的应用程序独立控制使用浅色主题还是深色主题，Android对此也是支持的，只要使用AppCompatDelegate.setDefaultNightMode()方法即可。

setDefaultNightMode()方法接收一个mode参数，用于控制当前应用程序的夜间模式。mode参数主要有以下值可供选择：

MODE_NIGHT_FOLLOW_SYSTEM：默认模式，表示让当前应用程序跟随系统设置来决定使用浅色主题还是深色主题。

MODE_NIGHT_YES：脱离系统设置，强制让当前应用程序使用深色主题。

MODE_NIGHT_NO：脱离系统设置，强制让当前应用程序使用浅色主题。

MODE_NIGHT_AUTO_BATTERY：根据手机的电池状态来决定使用浅色主题还是深色主题，如果开启了节点模式，则使用深色主题。

在MaterialTest当中，我们只需要使用如下代码就可以实现浅色主题和深色主题动态切换的功能：

class MainActivity : AppCompatActivity() {

override fun onCreate(savedInstanceState: Bundle?) {

...

fab.setOnClickListener { view ->

if (isDarkTheme(this)) {

AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO)

} else {

AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_YES)

}

...

}

运行之后的效果如下图所示。

需要注意的是，当调用setDefaultNightMode()方法并成功切换主题时，应用程序中所有处于started状态的Activity都会被重新创建（不在started状态的Activity则会在恢复started状态时再重新创建，关于started状态的解释可以参见《第一行代码第3版》的第13章，Lifecycles部分）。这很好理解，因为Activity不重新创建Activity怎么切换主题呢？

可是如果你当前所处的界面不想被重新创建，比如一个正在播放视频的界面。这个时候可以在Activity的configChanges属性当中配置uiMode来让当前Activity避免被重新创建，如下所示：

<activity

android:name=".MainActivity"

android:configChanges="uiMode" />

现在当应用程序的主题发生变化时，MainActivity并不会重新创建，而是会触发onConfigurationChanged()方法的回调，你可以在回调当中手动做一些逻辑处理。

override fun onConfigurationChanged(newConfig: Configuration) {

val currentNightMode = newConfig.uiMode and Configuration.UI_MODE_NIGHT_MASK

when (currentNightMode) {

Configuration.UI_MODE_NIGHT_NO -> {} // 夜间模式未启用，使用浅色主题

Configuration.UI_MODE_NIGHT_YES -> {} // 夜间模式启用，使用深色主题

}

如果什么都不做的话，当前的Activity就好像并没有切换主题一样，界面上也不会有任何变化。