黑暗的主题

Android Q提供了一个新的Dark主题，适用于Android系统UI和设备上运行的应用程序。

黑暗主题有很多好处：

可以大幅减少用电量（取决于设备的屏幕技术）。
提高低视力用户和对强光敏感的用户的可视性。
使任何人都可以在光线不足的环境中使用设备。

在Android Q中，有三种方法可以启用Dark主题：

新的系统设置（设置 - >显示 - >主题）允许用户启用黑暗主题。
新的“快速设置”磁贴允许用户从通知托盘中快速切换主题（一旦启用）。
在Pixel设备上，Battery Saver模式还可以同时启用Dark主题。其他OEM可能支持也可能不支持此行为。

在您的应用中支持Dark主题

为了支持Dark主题，您必须将应用程序的主题（通常位于 res/values/styles.xml）中设置为从DayNight主题继承：

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

您还可以使用 MaterialComponents的暗主题：

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

这将应用程序的主题与系统控制的夜间模式标记联系起来，并为应用程序提供默认的Dark主题（启用时）。

主题和风格

您的主题和样式应避免使用硬编码颜色或旨在在浅色主题下使用的图标。您应该使用主题属性（首选）或夜间限定资源。

以下是要了解的两个最重要的主题属性：

?android:attr/textColorPrimary这是一种通用文本颜色。它在Light主题中接近黑色，在Dark主题上接近白色。它包含一个禁用状态。
?attr/colorControlNormal通用图标颜色。它包含一个禁用状态。

我们建议使用Material Design Components，因为它的颜色主题系统（例如主题属性?attr/colorSurface和?attr/colorOnSurface）可以轻松访问合适的颜色。当然，您可以在主题中自定义这些属性。

在应用程序中更改主题

您可能希望允许用户在应用运行时更改应用的主题。您的应用可以让用户在主题之间进行选择。

在运行Android 9或更早版本的设备上运行时，推荐的主题选项为：

光
暗
由省电模式设置（推荐的默认选项）

在Android Q上运行时，建议的选项不同，以允许用户覆盖系统默认值：

光
暗
系统默认（推荐的默认选项）

请注意，如果用户选择Light，则Battery Saver不会更改该设置。

每个选项都直接映射到其中一种AppCompat.DayNight模式：

光 - MODE_NIGHT_NO
黑暗 - MODE_NIGHT_YES
由电池节电器设置 - MODE_NIGHT_AUTO_BATTERY
系统默认 - MODE_NIGHT_FOLLOW_SYSTEM

要切换主题，请调用AppCompatDelegate.setDefaultNightMode（）。

注意：从AppCompatv1.1.0-alpha05开始，setDefaultNightMode()不会自动重新创建任何已启动的活动。

强迫黑暗

Android Q提供Force Dark，这是开发人员在没有明确设置主题的情况下快速实现Dark主题的功能，DayNight如上所述。

Force Dark分析以光为主题的应用程序的每个视图，并在绘制到屏幕之前自动应用黑暗主题。一些开发人员使用Force Dark和本机实现的混合来减少实现Dark主题所需的时间。

应用必须通过设置android:forceDarkAllowed="true"应用主题来选择加入强黑。此属性设置在所有系统和AndroidX提供的轻量级主题上，例如Theme.Material.Light。当您使用Force Dark时，您应该确保彻底测试您的应用并根据需要排除视图。

如果您的应用使用黑暗主题（例如Theme.Material），则不会应用强制黑暗。同样，如果您的应用主题继承自DayNight主题，则由于自动主题切换，将不会应用强制黑暗。

禁用视图上的强制暗

可以使用android:forceDarkAllowed 布局属性或使用特定视图控制强制暗setForceDarkAllowed()。

最佳实践

通知和小部件

对于您在设备上显示但未直接控制的UI表面，确保您使用的任何视图都反映主机应用程序的主题非常重要。两个很好的例子是通知和启动器小部件。

通知

使用系统提供的通知模板（例如MessagingStyle）。这意味着系统负责确保应用正确的视图样式。

窗口小部件和自定义通知视图

对于启动器小部件，或者如果您的应用使用自定义通知内容视图，请务必确保在Light和Dark主题上测试内容。

需要注意的常见陷阱：

假设背景颜色总是很亮
硬编码文本颜色
使用默认文本颜色时设置硬编码背景颜色
使用可绘制的图标，这是一种静态颜色

在所有这些情况下，请使用适当的主题属性而不是硬编码颜色。

启动屏幕

如果您的应用具有自定义启动屏幕，则可能需要对其进行修改，以便它反映所选主题。

删除任何硬编码颜色，例如任何背景颜色指向可能是白色。请改用?android:attr/colorBackground主题属性。

请注意，以黑暗为主题的android:windowBackgrounddrawable仅适用于Android Q.

配置更改

当应用程序的主题更改时（通过系统设置或AppCompat），它会触发uiMode 配置更改。这意味着将自动重新创建活动。

在某些情况下，您可能希望应用程序处理配置更改。例如，您可能希望延迟配置更改，因为正在播放视频。

应用程序可以通过声明每个Activity可以处理uiMode 配置更改来处理Dark主题本身的实现：

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

当一个Activity声明它处理配置更改时，onConfigurationChanged()将在主题更改时调用其方法。

要检查当前主题是什么，应用可以运行如下代码：

Kotlin语言写法

val currentNightMode = configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK
when (currentNightMode) {Configuration.UI_MODE_NIGHT_NO -> {} // Night mode is not active, we're using the light themeConfiguration.UI_MODE_NIGHT_YES -> {} // Night mode is active, we're using dark theme
}

Java语言写法

int currentNightMode = configuration.uiMode & Configuration.UI_MODE_NIGHT_MASK
switch (currentNightMode) {case Configuration.UI_MODE_NIGHT_NO:// Night mode is not active, we're using the light themebreak;case Configuration.UI_MODE_NIGHT_YES:// Night mode is active, we're using dark themebreak;
}

Android Q(10.0)黑暗主题相关推荐

Android Q(10.0)的新功能和API
Android Q功能和API 目录: 安全性增强改进的生物识别认证对话框直接从APK运行嵌入式DEX代码 TLS 1.3支持 Public Conscrypt API 连接功能 Wi-Fi网络连 ...
Android Q(10.0)版本新特性以及兼容性适配
北京时间2019年3月14日Google正式对外发布Android Q Beta 1及预览版SDK,这意味着安卓开发者们又即将迎来一年一度的新版本适配工作了.Android Q 为开发者们带来了许多新 ...
android q(10.0)app应用卸载白名单
1.概述在10.0的系统产品开发中,对于app的卸载管理通常是有系统的PM负责管理的.所以在app应用卸载白名单功能的实现也是从PM在卸载方法中,按照白名单进行卸载 2.app应用卸载白名单的核心类 ...
华为android o适配名单,华为给出首批升级名单，这8款华为手机率先适配Android Q 10系统...
原标题:华为给出首批升级名单,这8款华为手机率先适配Android Q 10系统昨天,在谷歌的I/O大会上,谷歌正式向消费者介绍了Android Q 10系统中的新功能,除了自家的Pixel设备率先 ...
Android Q 10.1 KeyMaster源码分析(二) - 各家方案的实现
写在之前这两篇文章是我2021年3月初看KeyMaster的笔记,本来打算等分析完KeyMaster和KeyStore以后再一起做成一系列贴出来,后来KeyStore的分析中断了,这一系列的文章就变 ...
MTK平台安卓Q 10.0 camera驱动移植——sensor
平台MTK676X 安卓:Q/10.0 1. 添加驱动程序文件将模组厂商提供的驱动程序及调试参数文件拷贝到以下目录.厂商可能会自行客制化,但都是kernel和vendor两处下面,不一定和下面列出的 ...
Android Q(10) 拍照问题
Android Q官方文档 AndroidQ新增的分区存储 Android Q文件存储机制修改成了沙盒模式,和IOS神似应用只能访问自己沙盒下的文件和公共媒体文件对于Android Q以下,还是使 ...
android系统10.0模拟器,exagear模拟器安卓10.0
软件简介 exagear模拟器安卓10.0游戏是一款强大的游戏模拟器,这款模拟器可以轻松的模拟更多有趣的PC游戏,可以让玩家体验到热门火爆的游戏内容,在手机端轻松的安装下载,时刻享受端游带来的魅力,感 ...
android q wifi,Android Q 10连接到网络wifinetworksspecifier
由于Android Q不允许WifiManager添加网络,他们建议使用wifinetworksspecifier. 使用WifiNetworkSuggestionBuilder,我已经能够在状态栏上 ...

Android Q(10.0)黑暗主题