前言
早在四年前就准备做深色模式的,当时用的三方的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下的主题设置
同时还要注意如果单个Activity有自己的主题,也需要设置parent主题为Theme.AppCompat.DayNight.NoActionBar
。
ToolBar也有自己的主题:
其中
-
theme
为:,
-
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 声明它会处理配置变更时,系统会在出现主题背景变更时调用该 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,如有其他问题,欢迎留言骚扰~