Android 沉浸式(透明)状态栏细研-超级细还附 Demo

Posted 2022-11-18 ZeroFlutter

前言

在 android 4.4 中引入了沉浸模式的功能，但这个版本非真正的沉浸模式，应该说是透明模式。Android 5.0 以后才可以在系统层面实现真正的沉浸式状态栏。
沉浸式状态栏是为了与当前使用的 App 页面风格统一，不会显的那么突兀，保持友好且一致的用户体验而设计，是现在主流 App 必备的适配内容。今天我们就细细的研究一下沉浸式状态栏的适配。

先看效果

实现的功能

• 真透明状态栏（个别机型无法适配全透明，如锤子）
• 动态改变 ToolBar 或者自定义的 TitleBar 颜色，修改背景色即可，不需要动态改变状态栏颜色
• 状态栏主题模式（黑/白色）切换
• 修复适配 DrawerLayout 在 4.4 上白边的问题
• 适配“刘海屏”上的沉浸式状态栏
• 导航栏实现个人认为美观并通配的配色，可自定义修改

看实现代码

状态栏设置为透明

/**
 * 设置透明StatusBar
 *
 * @param activity Activity
 */
private static void setTranslucentStatusBar(Activity activity) 
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.KITKAT) 
        return;
    
    Window window = activity.getWindow();
    //透明状态栏
    window.setFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS, WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS);
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) 
        //5.0及以上版本,创建 Navigation Bar
        createNavBar(activity);
     else 
        //4.4 版本设置为透明状态栏
        window.addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
    

切换状态栏主题

这里主要是为了更好的适配页面背景，因为有的页面适合白色的状态栏图标，有的适合黑色的状态栏图标

/**
 * Android 6.0使用原始的主题适配
 *
 * @param activity Activity
 * @param darkMode 是否是黑色模式
 */
public static void setBarDarkMode(Activity activity, boolean darkMode) 
    Window window = activity.getWindow();
    if (window == null) 
        return;
    
    //设置StatusBar模式
    if (darkMode) //黑色模式
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) 
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) //设置statusBar和navigationBar为黑色
                window.getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR | View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR);
             else //设置statusBar为黑色
                window.getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR);
            
        
     else //白色模式
        int statusBarFlag = View.SYSTEM_UI_FLAG_VISIBLE;
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) 
            statusBarFlag = window.getDecorView().getSystemUiVisibility()
                & ~View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR;
        
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) //设置statusBar为白色，navigationBar为灰色
            //                int navBarFlag = window.getDecorView().getSystemUiVisibility()
            //                        & ~View.SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR;//如果想让navigationBar为白色，那么就使用这个代码。
            int navBarFlag = View.SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR;
            window.getDecorView().setSystemUiVisibility(navBarFlag | statusBarFlag);
         else 
            window.getDecorView().setSystemUiVisibility(statusBarFlag);
        
    
    setHuaWeiStatusBar(darkMode, window);

白色	黑色

设置 Navigation Bar 配色

现在是全面屏手机了，但是也可以设置开启虚拟导航栏的。这里主要是更改 Navigation Bar 在不同 Android 版本的配色，这里可以根据设计师的配色或者分装成接口使用。

/**
 * 创建Navigation Bar
 *
 * @param activity 上下文
 */
@TargetApi(Build.VERSION_CODES.LOLLIPOP)
private static void createNavBar(Activity activity) 
    int navBarHeight = getNavigationBarHeight(activity);
    int navBarWidth = getNavigationBarWidth(activity);
    if (navBarHeight > 0 && navBarWidth > 0) 
        //创建NavigationBar
        View navBar = new View(activity);
        FrameLayout.LayoutParams pl;
        if (activity.getResources().getConfiguration().orientation == Configuration.ORIENTATION_PORTRAIT) 
            pl = new FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, navBarHeight);
            pl.gravity = Gravity.BOTTOM;
         else 
            pl = new FrameLayout.LayoutParams(navBarWidth, ViewGroup.LayoutParams.MATCH_PARENT);
            pl.gravity = Gravity.END;
        
        navBar.setLayoutParams(pl);
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) 
            navBar.setBackgroundColor(Color.parseColor("#fffafafa"));
         else 
            navBar.setBackgroundColor(Color.parseColor("#40000000"));
        
        //添加到布局当中
        ViewGroup decorView = (ViewGroup) activity.getWindow().getDecorView();
        decorView.addView(navBar);
        //设置主布局PaddingBottom
        ViewGroup contentView = decorView.findViewById(android.R.id.content);
        if (activity.getResources().getConfiguration().orientation == Configuration.ORIENTATION_PORTRAIT) 
            contentView.setPaddingRelative(0, 0, 0, navBarHeight);
         else 
            contentView.setPaddingRelative(0, 0, navBarWidth, 0);
        

    

修复 DrawerLayout 顶部白边的问题

在实际项目中我们可能会用到 DrawerLayout ，但是设置了透明状态栏后，在 Android 4.4 上会出现顶部白边的问题，通过下面的方法可修复

/**
 * 设置 DrawerLayout 在4.4版本下透明，不然会出现白边
 *
 * @param drawerLayout DrawerLayout
 */
public static void setTranslucentDrawerLayout(DrawerLayout drawerLayout) 
    if (drawerLayout != null && Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT && Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) 
        drawerLayout.setFitsSystemWindows(true);
        drawerLayout.setClipToPadding(false);
    

到这里我们已经看到了实现的核心方法，我已经封装了一个 AndroidBarUtils ，方便项目中使用可以，下面我们介绍一下如何使用，并且你可以直接查看我编写好的 GitHub wiki

使用方法

如何引用？

暂时不提供远程库引用的方式，只有一个类，点击下载 然后放到项目中即可，也方便自己扩展。

调用方法

• 设置透明状态栏

AndroidBarUtils.setTranslucent(this);

• 修复重叠问题以及适配“刘海屏”(ToolBar、自定义的TitleBar、NavigationView 都可用)

//ToolBar、自定义的TitleBar 重叠问题以及适配刘海屏
AndroidBarUtils.setBarPaddingTop(this, view);

• 设置状态栏主题(6.0及以上才有效果)

//false:白色 true:黑色
AndroidBarUtils.setBarDarkMode(this, false);

不常见问题

• Android 4.4 上使用了 DrawerLayout 会出现白条,如何解决？

AndroidBarUtils.setTranslucentDrawerLayout(drawerLayout);

• 如何让 NavigationView 适配 刘海屏 ？

AndroidBarUtils.setBarPaddingTop(this,navigationView.getHeaderView(0));

最终效果

源码仓库

• GitHub 源码，顺手就是一个 Star
• 体验 Apk 下载

总结

本文我们为了优化用户的 App 使用体验，一起查看了 Android 各个版本上沉浸式(透明)状态栏的实现细节，并适配了黑白状态栏主题以及 DrawerLayout 和NavigationView 的异常情况。虽然是很小的一个优化的点，但是从页面美观和体验角度做了很大的提升。

参考：

• AdvancedImmersiveMode
• Display Cutouts-Android Developer
• System UI - Android Developer

关于我

• 15 年～18 年，使用 Android 原生做智能硬件相关的 App 研发
• 18 年 5 月，一次偶然的机会接触到了 Flutter ，然后开始自学，可以看 weather_flutter 是我练习 Flutter 的入门实战项目（我现在依然觉得他非常适合 Flutter 入门练习使用）
• 18 年 8 月，顶着巨大的压力（Flutter 当时还没有 Release 1.0）开始使用 Flutter 开发企业级项目，并且开发维护了十几个 Flutter 插件包（因为当时插件资源非常的匮乏）
• 截止目前主导并参与上线了 4 款企业级Flutter App，当前正在负责的一款 App 累计用户 120W+，使用 Flutter 得到了极佳的体验

👏 欢迎点赞➕收藏➕分享，有任何问题随时在下面👇评论，我会第一时间回复哦