Android 深色模式适配
- Android 深色模式适配
- 深色主题背景
- 在应用中支持深色主题背景
- 主题背景和样式
- Force Dark
- 在视图上停用 Force Dark
- Android 10以上
- 配置变更
Android 深色模式适配
深色主题背景
Android 10 (API 级别 29) 及更高版本中提供深色主题背景。深色主题背景具有诸多优势：
- 可大幅减少耗电量（具体取决于设备的屏幕技术）。
- 为弱视以及对强光敏感的用户提高可视性。
- 让所有人都可以在光线较暗的环境中更轻松地使用设备。
深色主题背景同时适用于 Android 系统界面和在设备上运行的应用。
在应用中支持深色主题背景
如要支持深色主题背景，必须将应用的主题背景（通常可在 res/values/styles.xml 中找到）设置为继承 DayNight 主题背景：
<style name="AppTheme" parent="Theme.AppCompat.DayNight">或者使用 MaterialComponent 的深色主题背景：
<style name="AppTheme" parent="Theme.MaterialComponents.DayNight">这会将应用的主要主题背景与系统控制的夜间模式标记相关联，并将应用的默认主题背景设置为深色主题背景（如果已启用）。
主题背景和样式
主题背景和样式应避免使用旨在于浅色主题背景下使用的硬编码颜色或图标。应改用主题背景属性（首选）或适合在夜间使用的资源。
以下是需要了解的两个最重要的主题背景属性：
-
?android:attr/textColorPrimary这是一种通用型文本颜色。它在浅色主题背景下接近于黑色，在深色主题背景下接近于白色。该颜色包含一个停用状态。 -
?attr/colorControlNormal一种通用图标颜色。该颜色包含一个停用状态。
Force Dark
Android 10 提供 Force Dark 功能。此功能可让开发者快速实现深色主题背景，而无需明确设置 DayNight 主题背景。
如果应用采用浅色主题背景，则 Force Dark 会分析应用的每个视图，并在相应视图在屏幕上显示之前，自动应用深色主题背景。有些开发者会混合使用 Force Dark 和本机实现，以缩短实现深色主题背景所需的时间。
如果应用选择启用 Force Dark，可以在其主题背景中设置 android:forceDarkAllowed="true"。此属性会在所有系统及 AndroidX 提供的浅色主题背景（例如 Theme.Material.Light）上设置。
<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
<item name="android:colorPrimaryDark">@color/colorPrimaryDark</item>
<item name="android:colorPrimary">@color/colorPrimary</item>
<item name="android:colorAccent">@color/colorAccent</item>
<item name="android:background">@color/colorPrimary</item>
<item name="windowNoTitle">true</item>
<!-- 启用 Force Dark -->
<item name="android:forceDarkAllowed">true</item>
</style>
</resources>如果应用使用深色主题背景（例如Theme.Material），则系统不会应用 Force Dark。同样，如果应用的主题背景继承自 DayNight 主题背景，则系统不会应用 Force Dark，因为会自动切换主题背景。
在视图上停用 Force Dark
您可以通过 android:forceDarkAllowed 布局属性或 setForceDarkAllowed() 在特定视图上控制 Force Dark。
Android 10以上
创建项目SDK选择API29: Android 10以上，res目录下会分别创建浅色和深色的主题样式。
其中values/themes.xml存放浅色模式主题，values-night/themes.xml存放深色模式主题。
如要切换主题背景，可以调用 AppCompatDelegate.setDefaultNightMode()。
配置变更
当应用的主题背景发生更改（无论是通过系统设置还是 AppCompat）时，会触发 uiMode 配置变更。这意味着系统会自动重新创建 Activity。
在某些情况下，可能希望应用处理配置变更。例如，可能希望延迟配置变更时间，因为设备正在播放视频。
应用可以声明，每个 Activity 都可以处理 uiMode 配置变更，以自行处理深色主题背景的实现：
<activity
android:name=".MyActivity"
android:configChanges="uiMode" />当某个 Activity 声明它会处理配置变更时，系统会在出现主题背景变更时调用该 Activity 的 onConfigurationChanged() 方法。
如要检查当前采用的是哪种主题背景，应用可以运行如下代码：
@Override
public void onConfigurationChanged(@NonNull Configuration newConfig) {
super.onConfigurationChanged(newConfig);
int currentNightMode = newConfig.uiMode & Configuration.UI_MODE_NIGHT_MASK;
switch (currentNightMode) {
case Configuration.UI_MODE_NIGHT_NO:
// Night mode is not active, we're using the light theme
Log.i(TAG, "onConfigurationChanged: light");
break;
case Configuration.UI_MODE_NIGHT_YES:
// Night mode is active, we're using dark theme
Log.i(TAG, "onConfigurationChanged: dark");
break;
default:
break;
}
}
