当前位置：首页 > news >正文

Android Q（10）黑暗模式适配的实现

news 2025/8/22 2:12:46

一、引言

随着 AndroidQ（10）的发布，黑暗模式成为了系统级别的特性。为了满足用户在不同环境下的使用需求，应用程序需要及时进行黑暗模式的适配。本文将详细介绍如何在 AndroidQ（10）上实现黑暗模式的适配，包括代码示例和详细步骤。

二、黑暗模式适配的基本原理

黑暗模式适配主要依赖于 Android 系统的主题切换功能。通过定义不同的主题样式，并在运行时根据系统设置动态切换主题，从而实现黑暗模式的适配。

三、实现步骤

定义主题样式

在 res/values 目录下创建两个主题样式文件：themes.xml（用于定义普通模式下的主题样式）和 themes_night.xml（用于定义黑暗模式下的主题样式）。

<!-- themes.xml -->
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar"><!-- 自定义样式属性 -->
</style><!-- themes_night.xml -->
<style name="AppTheme" parent="Theme.AppCompat.Dark.DarkActionBar"><!-- 自定义样式属性 -->
</style>

在 AndroidManifest.xml 中配置主题

在 AndroidManifest.xml 文件的 <application> 标签内配置应用的主题，并添加 android:configChanges 属性以监听系统主题变化。

<applicationandroid:allowBackup="true"android:icon="@mipmap/ic_launcher"android:label="@string/app_name"android:roundIcon="@mipmap/ic_launcher_round"android:supportsRtl="true"android:theme="@style/AppTheme"android:configChanges="uiMode">...
</application>

动态切换主题

在 Activity 中重写 onConfigurationChanged 方法，根据系统设置动态切换主题。

@Override
public void onConfigurationChanged(Configuration newConfig) {super.onConfigurationChanged(newConfig);int nightModeFlags = newConfig.uiMode & Configuration.UI_MODE_NIGHT_MASK;switch (nightModeFlags) {case Configuration.UI_MODE_NIGHT_YES:// 当前为黑暗模式，切换至黑暗主题AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_YES);break;case Configuration.UI_MODE_NIGHT_NO:// 当前为普通模式，切换至普通主题AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO);break;case Configuration.UI_MODE_NIGHT_UNDEFINED:// 未定义，根据系统设置切换主题AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_FOLLOW_SYSTEM);break;}
}