Android 深色模式的项目应用

语言: CN / TW / HK

theme: smartblue

小知识,大挑战!本文正在参与“程序员必备小知识”创作活动。

本文同时参与 「掘力星计划」  ,赢取创作大礼包,挑战创作激励金。

前言

早在四年前就准备做深色模式的,当时用的三方的SDK,但是SDK上还有bug,不能适配RecyclerView,用上后会很卡,然后就一直放着了,有些用户一直催着要深色模式:

然后这段期间给整上,本以为现在深色模式应用的挺广泛的,在项目中实践了一下还是躺了很多坑,梳理一下实践过程及遇到的问题。

所有代码实践在云阅里可以看到:

项目实践

1.选定原生Api实现

Android官方深色主题背景开发文档(需科学上网)。

原生Api简单稳定但是就是要重启App,不过看掘金以及微信都是这样实现的。

于是参考了微信和掘金的操作,总有三种状态,跟随系统,普通模式,深色模式。

设置深色模式

2.关键的工具类

```java 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里初始化

java NightModeUtil.initNightMode();

4.切换状态后重启App

java NightModeUtil.initNightMode(dayNightSwitch.isChecked, ctvCheckNight.isChecked) NightModeUtil.restartApp(activity)

其中还要保存是否跟随系统或指定深色模式的状态,具体逻辑细节可见:NavNightModeActivity.kt

5.Application下的主题设置

```java

```

同时还要注意如果单个Activity有自己的主题,也需要设置parent主题为Theme.AppCompat.DayNight.NoActionBar

ToolBar也有自己的主题: java <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也不能设置单个的LightDark主题,不然切换深色模式的时候也不会改变效果。

6.WebView的深色模式设置

引入implementation 'androidx.webkit:webkit:1.2.0'后可轻易的实现WebView的深色模式,不过有兼容问题,这和WebView的版本有关,WebView版本独立于Android版本。(亲测在系统6.0和7.1上无效。)

在有WebView的Activity的onCarete里加上如下代码: java 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: java <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的主题:

java // 设置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,如有其他问题,欢迎留言骚扰~