Android 深色模式的项目应用
前言
早在四年前就准备做深色模式的，当时用的三方的SDK，但是SDK上还有bug，不能适配RecyclerView，用上后会很卡，然后就一直放着了，有些用户一直催着要深色模式：
然后这段期间给整上，本以为现在深色模式应用的挺广泛的，在项目中实践了一下还是躺了很多坑，梳理一下实践过程及遇到的问题。
所有代码实践在云阅里可以看到：
- 下载App体验，酷安：云阅
- 直接查看源码，GitHub：CloudReader
项目实践
1.选定原生Api实现
Android官方深色主题背景开发文档(需科学上网)。
原生Api简单稳定但是就是要重启App，不过看掘金以及微信都是这样实现的。
于是参考了微信和掘金的操作，总有三种状态，跟随系统，普通模式，深色模式。
2.关键的工具类
public class NightModeUtil {
/**
* 当前系统是否是深色模式
*/
public static boolean isNightMode(Context context) {
int uiMode = context.getResources().getConfiguration().uiMode & Configuration.UI_MODE_NIGHT_MASK;
return uiMode == Configuration.UI_MODE_NIGHT_YES;
}
/**
* 获取是否跟随系统，默认true
*/
public static boolean getSystemMode() {
return SPUtils.getBoolean(Constants.KEY_MODE_SYSTEM, true);
}
public static void setSystemMode(boolean nightMode) {
SPUtils.putBoolean(Constants.KEY_MODE_SYSTEM, nightMode);
}
/**
* 获取是否设置深色模式，默认false
*/
public static boolean getNightMode() {
return SPUtils.getBoolean(Constants.KEY_MODE_NIGHT, false);
}
public static void setNightMode(boolean nightMode) {
SPUtils.putBoolean(Constants.KEY_MODE_NIGHT, nightMode);
}
public static void initNightMode() {
initNightMode(getSystemMode(), getNightMode());
}
/**
* 初始化App深色模式
*
* @param systemMode 是否是跟随系统
* @param nightMode 是否是深色模式
*/
public static void initNightMode(boolean systemMode, boolean nightMode) {
if (systemMode) {
AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_FOLLOW_SYSTEM);
} else {
if (nightMode) {
AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_YES);
} else {
AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO);
}
}
}
/**
* 重启App
*/
public static void restartApp(Activity activity) {
final Intent intent = App.getInstance().getPackageManager().getLaunchIntentForPackage(App.getInstance().getPackageName());
if (intent != null) {
intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
intent.addFlags(Intent.FLAG_ACTIVITY_NO_ANIMATION);
activity.startActivity(intent);
android.os.Process.killProcess(android.os.Process.myPid());
}
}
}3.在Application里初始化
NightModeUtil.initNightMode();4.切换状态后重启App
NightModeUtil.initNightMode(dayNightSwitch.isChecked, ctvCheckNight.isChecked)
NightModeUtil.restartApp(activity)其中还要保存是否跟随系统或指定深色模式的状态，具体逻辑细节可见:NavNightModeActivity.kt
5.Application下的主题设置
<style name="AppTheme" parent="Theme.AppCompat.DayNight.NoActionBar">
<!--选中状态icon的颜色和字体颜色-->
<item name="colorPrimary">@color/colorTheme</item>
<item name="colorPrimaryDark">@color/colorTheme</item>
<item name="colorAccent">@color/colorTheme</item>
<item name="android:windowAnimationStyle">@style/default_animation</item>
<item name="android:listDivider">@drawable/shape_line</item>
<!--默认状态下页面的背景色-->
<item name="android:windowBackground">@color/color_page_bg</item>
</style>同时还要注意如果单个Activity有自己的主题，也需要设置parent主题为Theme.AppCompat.DayNight.NoActionBar。
ToolBar也有自己的主题：
<androidx.appcompat.widget.Toolbar xmlns:app="http://schemas.android.com/apk/res-auto"
android:id="@+id/tool_bar"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
android:background="@color/colorToolBar"
app:contentInsetStart="0.0dp"
app:contentInsetStartWithNavigation="0dp"
app:layout_scrollFlags="enterAlways|scroll"
app:popupTheme="@style/ThemeOverlay.AppCompat.ActionBar"
app:subtitleTextAppearance="@style/Toolbar.SubTitle"
app:theme="@style/ToolbarStyle"
app:titleMarginStart="0dp"
app:titleTextAppearance="@style/ToolBar.Title"
tools:layout_height="50dp"
tools:title="云阅" />其中
-
theme为：<style name="ToolbarStyle" parent="@style/ThemeOverlay.AppCompat.ActionBar"/>， -
popupTheme也不能设置单个的Light或Dark主题，不然切换深色模式的时候也不会改变效果。
6.WebView的深色模式设置
引入implementation 'androidx.webkit:webkit:1.2.0'后可轻易的实现WebView的深色模式，不过有兼容问题，这和WebView的版本有关，WebView版本独立于Android版本。(亲测在系统6.0和7.1上无效。)
在有WebView的Activity的onCarete里加上如下代码：
WebSettings webSetting = webView.getSettings();
// 检查是否支持暗模式
if (WebViewFeature.isFeatureSupported(WebViewFeature.FORCE_DARK)) {
boolean isAppDarkMode;
if (NightModeUtil.getSystemMode()) {
// 是否是跟随系统
isAppDarkMode = NightModeUtil.isNightMode(this);
} else {
isAppDarkMode = NightModeUtil.getNightMode();
}
if (isAppDarkMode) {
WebSettingsCompat.setForceDark(webSetting, WebSettingsCompat.FORCE_DARK_ON);
} else {
WebSettingsCompat.setForceDark(webSetting, WebSettingsCompat.FORCE_DARK_OFF);
}
}7.配置项
1).接下来就是一些配色和部分深色模式下的图片处理问题。
- 颜色：新建
values-night文件夹，里面是深色模式下的colors.xml文件 - 图片：新建
drawable-night-xxhdpi图片文件夹
2).启动页我们经常会放品牌图，页面的深色模式可以通过 改变普通/深色模式文件夹下的图来实现
3).也可以自己处理配置变更，不重建Activity：
<activity
android:name=".NavNightModeActivity"
android:configChanges="uiMode" />当某个 Activity 声明它会处理配置变更时，系统会在出现主题背景变更时调用该 Activity 的 onConfigurationChanged()方法。
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 theme
Configuration.UI_MODE_NIGHT_YES -> {} // Night mode is active, we're using dark theme
}遇到的问题
1).获取颜色ContextCompat.getColor(context, resId)，需要加Activity的context，如果是Application的context会变不了色，这个和切换语言是一样的，获取String也不能用全局的context。
2).之前使用了关闭应用时杀掉进程的代码，导致不能重建Activity，找了好长时间问题。杀掉进程代码：android.os.Process.killProcess(android.os.Process.myPid());
3).如果代码需要单独动态设置ToolBar的主题：
// 设置toolbar的dark模式，为了使"完成"文字颜色显示白色
supportActionBar?.themedContext?.setTheme(R.style.ToolBarDarkActionBar)4).可以使用系统自己的颜色值：
-
?android:attr/textColorPrimary这是一种通用型文本颜色。它在浅色主题背景下接近于黑色，在深色主题背景下接近于白色。 -
?android:attr/textColorSecondary可作为第二文本颜色，相对于上面的颜色较浅。
5).在dialog打开后，再切换系统的深色模式，这时使用系统的颜色会不生效，需要使用自己的color文件里的颜色。具体出现在首次打开应用时，弹出的隐私弹框。
6).需要使用png后缀的图，最好别直接将jpg改为png，可以打开图片后将图片另存为png格式。我做时候debug模式下没问题，打release包的时候就提示了这个问题。
总结
使用官方给出的深色模式Api，实现起来比较简单，但是也有一些注意项和优化点，如有需要可自取代码 GitHub：CloudReader，如有其他问题，欢迎留言骚扰~
腾讯云开发者
