Android 浅色状态栏深色文字模式教程

我们都知道,安卓可以自定义状态栏是从 API19(4.4) 开始的,Google 给 KitKat 引入了 translucentStatusBar 特性。从此,安卓也可以像 iOS 一样自定义状态栏的颜色,甚至可以将布局布到状态栏后面。然而,一如往常谷歌出的东西都是坑的尿性,谷歌却没考虑到将状态栏设置为浅色后,状态栏上的文字和图标辨识困难的问题。(这不叫黑,这叫爱的深沉)

直到 Google 在 2015 年的 Google I/O 大会上推出了一个安卓状态栏的新特性:LightStatusBarWindow,即所谓的浅色状态栏模式。从 API19 到 API23 过了整整四个大版本,这才解决了这个问题。没错,重要的东西总是晚来一步。

然而,早在谷歌之前,国内的魅族与小米早已在自家的 Rom 中添加了浅色状态栏的功能。最低甚至支持 4.4 。但是很多安卓开发者并不知道此事,以至于很多 app 使用了浅色的状态栏导致用户无法看清状态栏上的文字图标。


左图是数字尾巴,正确使用了浅色状态栏模式。右图是某知名P2P app,未使用浅色状态栏模式,右上角的充电图标证明了该 app 并不是全屏状态而是的确没用浅色状态栏= =

MIUI、Flyme以及原生安卓的浅色状态栏实现各不相同。而且这三个实现该功能的最低版本要求也不同。MIUI 的要求为 MIUI V6 及以上,Flyme 为 Flyme4 及以上,原生安卓为 API23 及以上。考虑到国内 MIUI 及 Flyme 用户的数量,所以我们的 app 中势必需要对当前手机系统进行判断之后调用合适的方法来设置浅色状态栏。

以下是我总结的判断手机系统浅色状态栏是否可用的工具类:

public class RomUtils {

    class AvailableRomType {
        public static final int MIUI = 1;
        public static final int FLYME = 2;
        public static final int ANDROID_NATIVE = 3;
        public static final int NA = 4;
    }

    public static boolean isLightStatusBarAvailable () {
        if (isMIUIV6OrAbove() || isFlymeV4OrAbove() || isAndroidMOrAbove()) {
            return true;
        }
        return false;
    }

    public static int getLightStatausBarAvailableRomType() {
        if (isMIUIV6OrAbove()) {
            return AvailableRomType.MIUI;
        }

        if (isFlymeV4OrAbove()) {
            return AvailableRomType.FLYME;
        }

        if (isAndroidMOrAbove()) {
            return AvailableRomType.ANDROID_NATIVE;
        }

        return AvailableRomType.NA;
    }

    //Flyme V4的displayId格式为 [Flyme OS 4.x.x.xA]
    //Flyme V5的displayId格式为 [Flyme 5.x.x.x beta]
    private static boolean isFlymeV4OrAbove() {
        String displayId = Build.DISPLAY;
        if (!TextUtils.isEmpty(displayId) && displayId.contains("Flyme")) {
            String[] displayIdArray = displayId.split(" ");
            for (String temp : displayIdArray) {
                //版本号4以上,形如4.x.
                if (temp.matches("^[4-9]\\.(\\d+\\.)+\\S*")) {
                    return true;
                }
            }
        }
        return false;
    }

    //MIUI V6对应的versionCode是4
    //MIUI V7对应的versionCode是5
    private static boolean isMIUIV6OrAbove() {
        String miuiVersionCodeStr = getSystemProperty("ro.miui.ui.version.code");
        if (!TextUtils.isEmpty(miuiVersionCodeStr)) {
            try {
                int miuiVersionCode = Integer.parseInt(miuiVersionCodeStr);
                if (miuiVersionCode >= 4) {
                    return true;
                }
            } catch (Exception e) {}
        }
        return false;
    }

    //Android Api 23以上
    private static boolean isAndroidMOrAbove() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            return true;
        }
        return false;
    }

    private static String getSystemProperty(String propName) {
        String line;
        BufferedReader input = null;
        try {
            Process p = Runtime.getRuntime().exec("getprop " + propName);
            input = new BufferedReader(new InputStreamReader(p.getInputStream()), 1024);
            line = input.readLine();
            input.close();
        } catch (IOException ex) {
            return null;
        } finally {
            if (input != null) {
                try {
                    input.close();
                } catch (IOException e) {
                }
            }
        }
        return line;
    }
}

当判断当前系统可以使用浅色状态栏可以用后,根据得到的 Rom 类型调用对应的设置浅色状态栏方法:

public class LightStatusBarUtils {

    public static void setLightStatusBar(Activity activity, boolean dark) {
        switch (RomUtils.getLightStatausBarAvailableRomType()) {
            case RomUtils.AvailableRomType.MIUI:
                setMIUILightStatusBar(activity, dark);
                break;

            case RomUtils.AvailableRomType.FLYME:
                setFlymeLightStatusBar(activity, dark);
                break;

            case RomUtils.AvailableRomType.ANDROID_NATIVE:
                setAndroidNativeLightStatusBar(activity, dark);
                break;

            case RomUtils.AvailableRomType.NA:
                // N/A do nothing
                break;
        }
    }

    private static boolean setMIUILightStatusBar(Activity activity, boolean darkmode) {
        Class<? extends Window> clazz = activity.getWindow().getClass();
        try {
            int darkModeFlag = 0;
            Class<?> layoutParams = Class.forName("android.view.MiuiWindowManager$LayoutParams");
            Field field = layoutParams.getField("EXTRA_FLAG_STATUS_BAR_DARK_MODE");
            darkModeFlag = field.getInt(layoutParams);
            Method extraFlagField = clazz.getMethod("setExtraFlags", int.class, int.class);
            extraFlagField.invoke(activity.getWindow(), darkmode ? darkModeFlag : 0, darkModeFlag);
            return true;
        } catch (Exception e) {
            e.printStackTrace();
        }
        return false;
    }

    private static boolean setFlymeLightStatusBar(Activity activity, boolean dark) {
        boolean result = false;
        if (activity != null) {
            try {
                WindowManager.LayoutParams lp = activity.getWindow().getAttributes();
                Field darkFlag = WindowManager.LayoutParams.class
                        .getDeclaredField("MEIZU_FLAG_DARK_STATUS_BAR_ICON");
                Field meizuFlags = WindowManager.LayoutParams.class
                        .getDeclaredField("meizuFlags");
                darkFlag.setAccessible(true);
                meizuFlags.setAccessible(true);
                int bit = darkFlag.getInt(null);
                int value = meizuFlags.getInt(lp);
                if (dark) {
                    value |= bit;
                } else {
                    value &= ~bit;
                }
                meizuFlags.setInt(lp, value);
                activity.getWindow().setAttributes(lp);
                result = true;
            } catch (Exception e) {
            }
        }
        return result;
    }

    private static void setAndroidNativeLightStatusBar(Activity activity, boolean dark) {
        View decor = activity.getWindow().getDecorView();
        if (dark) {
            decor.setSystemUiVisibility(View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR);
        } else {
            // We want to change tint color to white again.
            // You can also record the flags in advance so that you can turn UI back completely if
            // you have set other flags before, such as translucent or full screen.
            decor.setSystemUiVisibility(0);
        }
    }

}

以上就是我总结的用于设置浅色状态栏的两个主要类:RomUtils 用于判定当前系统是否可用浅色状态栏模式,以及当前系统的类型。LightStatusBarUtils 包含了各个系统对应的设置浅色状态栏的方法,开发者可以根据 RomUtils 得到的 Rom 类型调用其中对应的方法。

接着我们创建一个 app 项目,来试试效果。在 MainActivity 的布局中我放了两个 TextView 和一个 Button。两个 TextView 分别用于显示当前系统版本信息和显示当前系统是否可用浅色状态栏模式。Button 用于在浅色状态栏模式和普通模式之间切换。

以下是 MainActivity :

public class MainActivity extends AppCompatActivity {

    private boolean isLightStatusBarNow = false;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        TextView sysInfoTv = (TextView) findViewById(R.id.tv_sys_info);
        TextView hintTv = (TextView) findViewById(R.id.tv_hint);
        Button switchBtn = (Button) findViewById(R.id.btn_switch);

        sysInfoTv.setText(Build.BRAND + " - " + Build.MODEL + " - SDK Version:" + Build.VERSION.SDK_INT);

        switch (RomUtils.getLightStatausBarAvailableRomType()) {
            case RomUtils.AvailableRomType.MIUI:
                hintTv.setText("当前系统为MIUI6或以上 浅色状态栏可用");
                break;

            case RomUtils.AvailableRomType.FLYME:
                hintTv.setText("当前系统为Flyme4或以上 浅色状态栏可用");
                break;

            case RomUtils.AvailableRomType.ANDROID_NATIVE:
                hintTv.setText("当前系统为Android M或以上 浅色状态栏可用");
                break;

            case RomUtils.AvailableRomType.NA:
                hintTv.setText("当前系统浅色状态栏不可用");
                switchBtn.setEnabled(false);
                switchBtn.setText("light status bar mode not available");
                break;
        }

        switchBtn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (isLightStatusBarNow) {
                    LightStatusBarUtils.setLightStatusBar(MainActivity.this, false);
                    isLightStatusBarNow = false;
                } else {
                    LightStatusBarUtils.setLightStatusBar(MainActivity.this, true);
                    isLightStatusBarNow = true;
                }

            }
        });

    }
}

手机上运行效果:


效果图

一些常见机型上的效果:


一些常见机型上的效果

存在的坑:

  • 使用原生安卓的方法来实现浅色状态栏的前提是,当前 Activity 所在的 Window 必须有 windowDrawsSystemBarBackgrounds 属性,而且必须未设置过 windowTranslucentStatus 属性。
    如果当前 Window 设置了 windowTranslucentStatus 属性,那么调用上面设置浅色状态栏的方法就不会生效。
    详细见 API 说明:
    https://developer.android.com/reference/android/R.attr.html#windowLightStatusBar
  • 据说安卓原生实现方法在 MIUI android 版本为6.0上无效(见参考2,手头没设备测试)。所以我的代码中将 MIUI 和 Flyme 的判断放在原生安卓前面,这样如果是 MIUI 或 Flyme 的设备,优先调用各自的实现方法。
Demo代码: 地址

参考:

  1. http://blog.isming.me/2016/01/09/chang-android-statusbar-text-color/
  2. http://www.jianshu.com/p/7f5a9969be53
  3. http://dev.xiaomi.com/doc/?p=254
  4. http://blog.csdn.net/devilkin64/article/details/19415717

本文章为原创作品,转载请注明出处。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 156,265评论 4 359
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,274评论 1 288
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 106,087评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,479评论 0 203
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,782评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,218评论 1 207
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,594评论 2 309
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,316评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,955评论 1 237
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,274评论 2 240
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,803评论 1 255
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,177评论 2 250
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,732评论 3 229
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,953评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,687评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,263评论 2 267
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,189评论 2 258

推荐阅读更多精彩内容