Android 沉浸式解析和轮子使用

解释：为 setsystemUIVisibility(int) 方法添加的 Flag,请求 status bar 绘制模式，它可以兼容亮色背景的status bar 。要在设置了 FLAGDRAWSSYstembarBACKGROUNDSflag ,同时清除了 FLAGTRANSLUCENTSTATUSflag 才会生效。

通过代码设置：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {            getwindow().getDecorVIEw().setsystemUIVisibility(                    VIEw.SYstem_UI_FLAG_LAYOUT_FulLSCREEN|VIEw.SYstem_UI_FLAG_liGHT_STATUS_bar);}

效果如下：

<style name="theme" parent="theme.Design.light.NoActionbar">        <item name="androID:windowTranslucentStatus">false</item>        <item name="androID:windowDrawsSystembarBackgrounds">true</item>        <item name="androID:statusbarcolor">@androID:color/holo_red_light</item>        <!-- AndroID 6.0以上 状态栏字色和图标为浅黑色-->        <item name="androID:windowlightStatusbar">true</item>    </style>

在实际开发过程中，我们不仅仅只会遇到以上三种版本兼容问题，还需要考虑如：不同手机品牌，动态该状态栏背景，以及 Fragment 中需要有自己的状态栏颜色场景。所以需要综合考虑多种场景，达到能适配多种开发情况的要求。
总结出以下场景：

我们希望将设置沉浸式效果都封装在一个类里面，想达到所有的效果通过一个方法设置，但很多的效果中都会有重复的设置步骤，并且每个效果的方法太多则分不清使用哪个，所以将设置沉浸式效果拆分成几个步骤，而想要设置个性效果，通过方法设置参数，最后通过init方法收集所有参数让后统一设置参数属性。

ZanImmersionbar.with(this).init();//该方法将进行以下步骤处理沉浸式public voID init() {        //更新bar的参数        updatebarParams();        //设置沉浸式        setbar();        //适配状态栏与布局重叠问题        fitsLayoutOverlap();        //适配软键盘与底部输入框冲突问题        fitsKeyboard();        //变色vIEw        transformVIEw();    }

沉浸式设置流程如下图：

我们使用一个对象用于存储用户设置的 bar 参数，这些参数有状态栏和导航栏颜色、透明度、显示隐藏等等,通过该对象中的参数来分别设置

public class barParams implements Cloneable {    /**     * 状态栏颜色     */    @colorInt    int statusbarcolor = color.transparent;    /**     * 导航栏颜色     */    @colorInt    int navigationbarcolor = color.BLACK;    /**     * The Default navigation bar color.     */    int defaultNavigationbarcolor = color.BLACK;    /**     * 状态栏透明度     */    @floatRange(from = 0f, to = 1f)    float statusbarAlpha = 0.0f;    /**     * 导航栏透明度     */    @floatRange(from = 0f, to = 1f)    float navigationbarAlpha = 0.0f;      //等其他属性    ...}

而这些属性可以通过以下ZanImmersionbar提供的方法进行个性化设置，而这些方法只是将需要设置的参数添加到barParams对象中，最后必须调用init将参数设置上去。

 ZanImmersionbar.with(this)             .transparentStatusbar()  //透明状态栏，不写默认透明色             .transparentNavigationbar()  //透明导航栏，不写默认黑色(设置此方法，fullScreen()方法自动为true)             .transparentbar()             //透明状态栏和导航栏，不写默认状态栏为透明色，导航栏为黑色（设置此方法，fullScreen()方法自动为true）             .statusbarcolor(R.color.colorPrimary)     //状态栏颜色，不写默认透明色             .navigationbarcolor(R.color.colorPrimary) //导航栏颜色，不写默认黑色             .barcolor(R.color.colorPrimary)  //同时自定义状态栏和导航栏颜色，不写默认状态栏为透明色，导航栏为黑色             .statusbarAlpha(0.3f)  //状态栏透明度，不写默认0.0f             .navigationbarAlpha(0.4f)  //导航栏透明度，不写默认0.0F             .barAlpha(0.3f)  //状态栏和导航栏透明度，不写默认0.0f             .statusbarDarkFont(true)   //状态栏字体是深色，不写默认为亮色             .navigationbarDarkIcon(true) //导航栏图标是深色，不写默认为亮色                           //等一些其他方法             .init();  //必须调用方可沉浸式

设置完参数后，则需要收集这些参数，如果在Fragment中使用，则需要Activity同步Fragment的barParams参数

//获得bar相关信息//如果在Fragment中使用，让Activity同步Fragment的barParams参数if (mIsFragment) {    ZanImmersionbar immersionbar = mImmersionbarMap.get(mActivity.toString());    if (immersionbar != null) {        immersionbar.mbarParams = mbarParams;    }}

mImmersionbarMap 是个 Map，用于存储每个 Activity 对应的 ZanImmersionbar 对象

原理：其实我们通过沉浸式三代发展史，我们可以知道设置沉浸式都是通过改变Activity的window属性达到沉浸式，所以我们想要在Fragment的定制化沉浸式，其实是通过改变Activity的barParams参数再设置Activity的沉浸式，所以需要注意对Fragment设置沉浸式前必须保证加载Fragment的Activity先进行了ZanImmersionbar的init初始化。

另例：需要注意dialogFragment和Dialog是有自己的window，该window是属于所属Activity的子window，所以设置dialogFragment和Dialog的沉浸式改变的是自己window里的属性，而不是改变Actvity的window里的属性。

关闭销毁：在activity的onDestroy方法中执行，因为mImmersionbarMap存储了每个Activity对应的ZanImmersionbar对象，所以当Activity关闭了需要及时释放，不然mImmersionbarMap会存在过多无用的ZanImmersionbar对象。

  ZanImmersionbar.with(this).destroy(); //必须调用该方法，防止内存泄漏   public voID destroy() {          //取消监听          cancelListener();          //删除当前界面对应的Immersionbar对象          Iterator<Map.Entry<String, ZanImmersionbar>> iterator = mImmersionbarMap.entrySet().iterator();          while (iterator.hasNext()) {              Map.Entry<String, ZanImmersionbar> entry = iterator.next();              if (entry.getKey().contains(mImmersionbarname) || (entry.getKey().equals(mImmersionbarname))) {                  iterator.remove();              }          }      }

该方法则是将上一步的参数进行初始化，初始化过程则会根据沉浸式三个阶段和不同厂商进行区分设置。需要注意小米手机系统有自己定制化设置的属性，所以需要分区设置：

private voID setbar() {    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LolliPOP && !OSUtils.isEMUI3_x()) {            //适配刘海屏            fitsNotchScreen();            //初始化5.0以上，包含5.0            uiFlags = initBaraboveLolliPOP(uiFlags);            //androID 6.0以上设置状态栏字体为暗色            uiFlags = setStatusbarDarkFont(uiFlags);            //androID 8.0以上设置导航栏图标为暗色            uiFlags = setNavigationIconDark(uiFlags);        } else {            //初始化5.0以下，4.4以上沉浸式            initbarBelowLolliPOP();        }             ...     }    if (OSUtils.isMiui6Later()) {        //修改miui状态栏字体颜色        setMiuibarDark(mWindow, Miui_STATUS_bar_DARK, mbarParams.statusbarDarkFont);        //修改miui导航栏图标为黑色        if (mbarParams.navigationbarEnable) {            setMiuibarDark(mWindow, Miui_NAVIGATION_bar_DARK, mbarParams.navigationbarDarkIcon);        }    }    ...}

我们可以重点看下5.0以上状态栏和导航栏初始化，设置初始化window属性让后设置导航栏和状态栏颜色。

@RequiresAPI(API = Build.VERSION_CODES.LolliPOP)private int initBaraboveLolliPOP(int uiFlags) {    //Activity全屏显示，但状态栏不会被隐藏覆盖，状态栏依然可见，Activity顶端布局部分会被状态栏遮住。    uiFlags |= VIEw.SYstem_UI_FLAG_LAYOUT_FulLSCREEN;    mWindow.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);    //判断是否存在导航栏    if (mbarConfig.hasNavigationbar()) {        mWindow.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);    }    //需要设置这个才能设置状态栏和导航栏颜色    mWindow.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYstem_bar_BACKGROUNDS);    //设置状态栏颜色    if (mbarParams.statusbarcolorEnabled) {        mWindow.setStatusbarcolor(colorUtils.blendARGB(mbarParams.statusbarcolor,                mbarParams.statusbarcolortransform, mbarParams.statusbarAlpha));    } else {        mWindow.setStatusbarcolor(colorUtils.blendARGB(mbarParams.statusbarcolor,                color.transparent, mbarParams.statusbarAlpha));    }      ...    return uiFlags;}

通过代码分析可以看到其实 ZanImmersionbar 所做的事情就是将设置沉浸式方法进行步骤拆分和增加个性属性设置，并且将沉浸式三个阶段和不同厂商进行区分独立方法设置调用。

   public class BaseActivity extends AppCompatActivity {

        @OverrIDe

        protected voID onCreate(@Nullable Bundle savedInstanceState) {

            super.onCreate(savedInstanceState);

            // 所有子类都将继承这些相同的属性,请在设置界面之后设置

            ZanImmersionbar.with(this).init();  

        }

        @OverrIDe

        protected voID onDestroy() {

            super.onDestroy();

            // 必须调用该方法，防止内存泄漏

            ZanImmersionbar.with(this).destroy();  

        }

    }

注意在 Fragment 中使用 ZanImmersionbar 需要在承载的 Activity 中初始化 ZanImmersionbar,不然会抛出异常。

    public abstract class BaseFragment{         @OverrIDe        public voID onVIEwCreated(@NonNull VIEw vIEw, @Nullable Bundle savedInstanceState) {             super.onVIEwCreated(vIEw, savedInstanceState);             initImmersionbar();    }         @OverrIDe       public voID initImmersionbar() {            ZanImmersionbar.with(this).keyboardEnable(true).init();        }    }

具体的Fragment调用以下方法:

    @OverrIDe    public voID initImmersionbar() {        super.initImmersionbar();        ZanImmersionbar.with(this)                .statusbarDarkFont(true)                .statusbarcolor(R.color.btn1)                .navigationbarcolor(R.color.btn1)                .init();    }

在 Dialog 中设置 ZanImmersionbar 方式和在 Fragment 或者 Activity 一样，如果在 Fragment 或者 Activity 中有设置并且 dialog 出现不需要改变状态栏则不用设置 ZanImmersionbar，如果需要做定制化上面的高级用法在 Dialog 也支持

      ZanImmersionbar.with(this).init();

其他dialog

      ZanImmersionbar.with(this, dialog).init();

重点是调用以下方法，但是此方法会导致有导航栏的手机底部布局会被导航栏覆盖，还有底部输入框无法根据软键盘d出而d出。这个属性在顶部d出的时候是需要使用，如果是底部d框需要看情况而定。

    popupWindow.setClipPingEnabled(false);

正常使用 ZanImmersionbar 一般不需要考虑重叠问题但在项目中接入 ZanImmersionbar 并且页面没有考虑给头部控件预留出状态栏的高度，并且需要将页面内容沉浸到状态栏或者做定制化状态栏，这种情况下需要考虑重叠问题。之前说到 AndroID4.4 版本的时候解决重叠的方式是一种，也可以参考一下几种方式解决状态栏与布局顶部重叠问题。
① 使用 dimen 自定义状态栏高度，不建议使用，因为设备状态栏高度并不是固定的在 values-v19/dimens.xml 文件下

        <dimen name="status_bar_height">25dp</dimen>

在values/dimens.xml文件下

        <dimen name="status_bar_height">0dp</dimen>

然后在布局界面添加vIEw标签，高度指定为statusbarheight

      <linearLayout xmlns:androID="http://schemas.androID.com/apk/res/androID"

          xmlns:app="http://schemas.androID.com/apk/res-auto"

          androID:layout_wIDth="match_parent"

          androID:layout_height="match_parent"

          androID:background="@color/darker_gray"

          androID:orIEntation="vertical">

          <VIEw

              androID:layout_wIDth="match_parent"

              androID:layout_height="@dimen/status_bar_height"

              androID:background="@color/colorPrimary" />

          <androID.support.v7.Widget.Toolbar

              androID:layout_wIDth="match_parent"

              androID:layout_height="wrap_content"

              androID:background="@color/colorPrimary"

              app:title="方法一"

              app:TitleTextcolor="@androID:color/white" />

      </linearLayout>

② 使用系统的fitsSystemwindows属性，使用该属性不会导致输入框与软键盘冲突问题，不要再Fragment使用该属性

       <linearLayout xmlns:androID="http://schemas.androID.com/apk/res/androID"           androID:layout_wIDth="match_parent"           androID:layout_height="match_parent"           androID:orIEntation="vertical"           androID:fitsSystemwindows="true">       </linearLayout>

然后使用Immersionbar时候必须指定状态栏颜色

       ZanImmersionbar.with(this)            .statusbarcolor(R.color.colorPrimary)            .init();

注意：ZanImmersionbar一定要在设置完布局以后使用

③ 使用ZanImmersionbar的fitsSystemwindows(boolean fits)方法

        ZanImmersionbar.with(this)            .fitsSystemwindows(true)  //使用该属性,必须指定状态栏颜色            .statusbarcolor(R.color.colorPrimary)            .init();

④ 使用ZanImmersionbar的statusbarVIEw(VIEw vIEw)方法

在标题栏的上方增加VIEw标签，高度指定为0dp

       <linearLayout xmlns:androID="http://schemas.androID.com/apk/res/androID"

              xmlns:app="http://schemas.androID.com/apk/res-auto"

              androID:layout_wIDth="match_parent"

              androID:layout_height="match_parent"

              androID:background="@color/darker_gray"

              androID:orIEntation="vertical">

              <VIEw

                  androID:layout_wIDth="match_parent"

                  androID:layout_height="0dp"

                  androID:background="@color/colorPrimary" />

              <androID.support.v7.Widget.Toolbar

                  androID:layout_wIDth="match_parent"

                  androID:layout_height="wrap_content"

                  androID:background="@color/colorPrimary"

                  app:title="方法四"

                  app:TitleTextcolor="@androID:color/white" />

       </linearLayout>

然后使用ZanImmersionbar的statusbarVIEw方法，指定vIEw就可以啦

         ZanImmersionbar.with(this)               .statusbarVIEw(vIEw)               .init();         //或者         //ZanImmersionbar.setStatusbarVIEw(this,vIEw);

⑤ 使用ZanImmersionbar的Titlebar(VIEw vIEw)方法，原理是设置paddingtop

             ZanImmersionbar.with(this)                   .Titlebar(vIEw) //可以为任意vIEw，如果是自定义xml实现标题栏的话，最外层节点不能为relativeLayout                   .init();             //或者             //ZanImmersionbar.setTitlebar(this, vIEw);

⑥ 使用ZanImmersionbar的Titlebarmargintop(VIEw vIEw)方法，原理是设置margintop

             ZanImmersionbar.with(this)                   .Titlebarmargintop(vIEw)  //可以为任意vIEw                   .statusbarcolor(R.color.colorPrimary)  //指定状态栏颜色,根据情况是否设置                   .init();             //或者使用静态方法设置             //ZanImmersionbar.setTitlebarmargintop(this,vIEw);

总结在处理 AndroID 沉浸式状态栏和导航栏开始会很头大，并且会不理解相关设置的 window 的 FLAG 属性，想要分清楚这些属性的大意需要从出现背景出发拆封，先熟悉沉浸式出现的3个阶段的属性和版本能做什么和不能做什么，然后再去了解各个厂家定制化的属性在哪些版本阶段使用，以及是否需要对异形屏适配，最后才是在实际开发和需求中对状态栏和导航栏处理。不过在 AndroID6.0 以后版本厂家的定制化状态已经越来越没有意义了，以后 AndroID 原生趋势也将会让开发者使用沉浸式越来越舒服。