沉浸式狀態欄源碼分析

開源項目system bar tint的鏈接

**

何爲沉浸式

**
上圖：

傳統意義上的狀態欄如下圖：

當我們對界面要求非常苛刻（顏色要統一），我們就需要用沉浸式。值得注意的是，沉浸式狀態欄只能用於4.4以上的設備。對於4.4一下的設備，我們並沒有辦法實現

我們先來看下git上關於該項目的使用方法。

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    // create our manager instance after the content view is set
    SystemBarTintManager tintManager = new SystemBarTintManager(this);
    // enable status bar tint
    tintManager.setStatusBarTintEnabled(true);
    // enable navigation bar tint
    tintManager.setNavigationBarTintEnabled(true);
}

我們首先獲得了system bar tint manager，然後設置狀態欄沉浸，最後一行代碼還有關於導航欄的沉浸。不過這不重要。
如果你自己運行下demo你就會發現，這時候狀態欄是透明瞭，但是，狀態欄僅是透明色，並沒有和主體顏色融爲一體，所以，在設置狀態欄沉浸的時候，你還需要設置下狀態欄的顏色，如下：

// set a custom tint color for all system bars
tintManager.setTintColor(Color.parseColor("#99000FF"));
// set a custom navigation bar resource
tintManager.setNavigationBarTintResource(R.drawable.my_tint);
// set a custom status bar drawable
tintManager.setStatusBarTintDrawable(MyDrawable);

不過我覺得，有些flag是針對4.4的，我們還是要加個if判斷，比如筆者下面的代碼（有些東西你直接忽略好了，這是我的工程代碼）

  @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        ActivityCollector.addActivity(this);

        m_activityComponent = DaggerActivityComponent.builder()
                .applicationComponent(((MPApplication) getApplication()).getApplicationComponent())
                .activityModule(new ActivityModule(this)).build();

        //針對4.4以上的設備設置沉浸式狀態欄
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            getWindow().addFlags(FLAG_TRANSLUCENT_STATUS);
            SystemBarTintManager systemBarTintManager = m_activityComponent
                .getSystemBarTintManager();
            systemBarTintManager.setStatusBarTintColor(getResources()
            .getColor(R.color.colorPrimary));
            systemBarTintManager.setStatusBarTintEnabled(true);
        }

        initPresenter();
        m_iPresenter = obtainIPresenter();
    }

可以看到，我們首先設置了window的flag，表面我們要透明狀態欄：

getWindow().addFlags(FLAG_TRANSLUCENT_STATUS);

這裏的window其實是一個phone window實例，具體的已經設計到activity如何加載到屏幕上了，具體的讀者可以參考相關的源碼分析書籍

然後我們構造了一個system bar tint manager

 SystemBarTintManager systemBarTintManager = m_activityComponent.getSystemBarTintManager();

這是我寫的代碼，讀者不必在乎，具體的代碼如下：

    @Provides
    @PerActivity
    public SystemBarTintManager provideSystemBarTintManager() {
        return new SystemBarTintManager(m_activity);
    }

我們切進構造函數看下

    @TargetApi(19)
    public SystemBarTintManager(Activity activity) {

        //獲得window對象，其實是PhoneWindow
        Window win = activity.getWindow();
        //獲得decor
        ViewGroup decorViewGroup = (ViewGroup) win.getDecorView();

        //一定要是4.4以上的設備
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            // check theme attrs
            // 查看屬性是否含有透明狀態欄 透明導航欄
            int[] attrs = {android.R.attr.windowTranslucentStatus,
                    android.R.attr.windowTranslucentNavigation};
            TypedArray a = activity.obtainStyledAttributes(attrs);
            try {
                mStatusBarAvailable = a.getBoolean(0, false);
                mNavBarAvailable = a.getBoolean(1, false);
            } finally {
                a.recycle();
            }

            // check window flags
            // 看下window是否設置了狀態欄透明
            // 看下導航是否設置了透明
            WindowManager.LayoutParams winParams = win.getAttributes();
            int bits = WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS;
            if ((winParams.flags & bits) != 0) {
                mStatusBarAvailable = true;
            }
            bits = WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION;
            if ((winParams.flags & bits) != 0) {
                mNavBarAvailable = true;
            }
        }

        //創建SystemBarConfig對象，我們一會兒看下有什麼用處
        mConfig = new SystemBarConfig(activity, mStatusBarAvailable, mNavBarAvailable);
        // device might not have virtual navigation keys
        // 注意 並不是所有的設備都有虛擬的導航鍵
        // 所以這裏還是要檢查下
        if (!mConfig.hasNavigtionBar()) {
            mNavBarAvailable = false;
        }

        //開始安裝用戶需要的沉浸式導航，狀態欄
        if (mStatusBarAvailable) {
            setupStatusBarView(activity, decorViewGroup);
        }
        if (mNavBarAvailable) {
            setupNavBarView(activity, decorViewGroup);
        }

    }

這裏很多讀者估計會很困惑什麼事decor
我引入一張圖：

可以看到一個activity並不是很簡單的，其中有包含一個PhoneWindow，而一個phone window裏面有包含decor view,decor view其實是一個view group，它包含兩個部分，一個是title view用於存放標題之類的內容，而content views 則是真正存放用戶自定義的layout內容了。回想一下，我們在定義佈局的時候，通常會使用：

  <?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:gravity="center"
    android:background="@color/colorNormal"/>

細想一下，我們的跟節點之外並無其它節點啊，爲啥還要match_parent？現在看來，豁然開朗，不過這個參數只針對調用activity的setContentView有用哦！

    //繼續跟蹤 看下 status bar 是如何安裝的
    private void setupStatusBarView(Context context, ViewGroup decorViewGroup) {

        //創建了一個view
        mStatusBarTintView = new View(context);
        //設置下寬高  不過到這裏 我們確實好像有必要看下SystemBarConfig是啥了
        LayoutParams params = new LayoutParams(
        LayoutParams.MATCH_PARENT, mConfig.getStatusBarHeight());
        params.gravity = Gravity.TOP;

        //看下導航欄是否存在 如果存在 並且 還不在底部 那就可能旋轉了屏幕 出現在
        //屏幕的右端 這時候就要設置下right margin
        if (mNavBarAvailable && !mConfig.isNavigationAtBottom()) {
            params.rightMargin = mConfig.getNavigationBarWidth();
        }

        //設置下佈局參數
        mStatusBarTintView.setLayoutParams(params);
        //設置下背景顏色 其實這裏是可以自定義的
        mStatusBarTintView.setBackgroundColor(DEFAULT_TINT_COLOR);
        //設置它爲不可見
        mStatusBarTintView.setVisibility(View.GONE);
        //把他添加到decor中
        decorViewGroup.addView(mStatusBarTintView);
    }

我們看下SystemBarConfig:

    //爲了方便讀者閱讀 我都貼出了所有的field 
    private static final String STATUS_BAR_HEIGHT_RES_NAME = "status_bar_height";
        private static final String NAV_BAR_HEIGHT_RES_NAME = "navigation_bar_height";
        private static final String 
        NAV_BAR_HEIGHT_LANDSCAPE_RES_NAME = "navigation_bar_height_landscape";
        private static final String NAV_BAR_WIDTH_RES_NAME = "navigation_bar_width";
        private static final String SHOW_NAV_BAR_RES_NAME = "config_showNavigationBar";

        private final boolean mTranslucentStatusBar;
        private final boolean mTranslucentNavBar;
        private final int mStatusBarHeight;
        private final int mActionBarHeight;
        private final boolean mHasNavigationBar;
        private final int mNavigationBarHeight;
        private final int mNavigationBarWidth;
        private final boolean mInPortrait;
        private final float mSmallestWidthDp;

        private SystemBarConfig(Activity activity, 
        boolean translucentStatusBar, boolean traslucentNavBar) {
            Resources res = activity.getResources();
            //獲得現在屏幕的方向
            mInPortrait = (res.getConfiguration().orientation == Configuration.ORIENTATION_PORTRAIT);
            //獲得下屏幕的最小dp值
            mSmallestWidthDp = getSmallestWidthDp(activity);
            //獲得狀態欄的高度
            mStatusBarHeight = getInternalDimensionSize(res, STATUS_BAR_HEIGHT_RES_NAME);
            //獲得action bar的高度
            mActionBarHeight = getActionBarHeight(activity);
            //獲得導航欄的高度 寬度
            mNavigationBarHeight = getNavigationBarHeight(activity);
            mNavigationBarWidth = getNavigationBarWidth(activity);
            //測試是否含有虛擬的導航欄
            mHasNavigationBar = (mNavigationBarHeight > 0);

            //這兩個數值是由外部傳入的
            mTranslucentStatusBar = translucentStatusBar;
            mTranslucentNavBar = traslucentNavBar;
        }

好像不是太複雜 都是一大堆獲得系統配置的函數 我們一個個的看吧

    //好像不是很複雜
    @SuppressLint("NewApi")
    private float getSmallestWidthDp(Activity activity) {
            DisplayMetrics metrics = new DisplayMetrics();
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
            //獲得一些顯示的參數
                activity.getWindowManager().getDefaultDisplay().getRealMetrics(metrics);
            } else {
                // TODO this is not correct, but we don't really care pre-kitkat
                activity.getWindowManager().getDefaultDisplay().getMetrics(metrics);
            }


            float widthDp = metrics.widthPixels / metrics.density;
            float heightDp = metrics.heightPixels / metrics.density;
            return Math.min(widthDp, heightDp);
        }

        //獲得內部的面積
        private int getInternalDimensionSize(Resources res, String key) {
            int result = 0;
            int resourceId = res.getIdentifier(key, "dimen", "android");
            if (resourceId > 0) {
                result = res.getDimensionPixelSize(resourceId);
            }
            return result;
        }

關於resource的getIdentifier函數，我們看下說明：

        @TargetApi(14)
        private int getActionBarHeight(Context context) {
            int result = 0;
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.ICE_CREAM_SANDWICH) {
                TypedValue tv = new TypedValue();
                //感覺漲了好多姿勢
                context.getTheme().resolveAttribute(android.R.attr.actionBarSize, tv, true);
                result = context.getResources().getDimensionPixelSize(tv.resourceId);
            }
            return result;
        }

        @TargetApi(14)
        private int getNavigationBarHeight(Context context) {
            Resources res = context.getResources();
            int result = 0;
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.ICE_CREAM_SANDWICH) {
                if (hasNavBar(context)) {
                    String key;
                    if (mInPortrait) {
                        key = NAV_BAR_HEIGHT_RES_NAME;
                    } else {
                        key = NAV_BAR_HEIGHT_LANDSCAPE_RES_NAME;
                    }

                    //調用和計算status bar高度一樣的函數
                    return getInternalDimensionSize(res, key);
                }
            }
            return result;
        }

分析完了沉浸式狀態欄是如何做的 我們看下導航欄

同樣是調用的安裝函數：

  private void setupNavBarView(Context context, ViewGroup decorViewGroup) {
        mNavBarTintView = new View(context);
        LayoutParams params;
        if (mConfig.isNavigationAtBottom()) {
            params = new LayoutParams(LayoutParams.MATCH_PARENT, mConfig.getNavigationBarHeight());
            params.gravity = Gravity.BOTTOM;
        } else {
            //可能顯示在右邊
            params = new LayoutParams(mConfig.getNavigationBarWidth(), LayoutParams.MATCH_PARENT);
            params.gravity = Gravity.RIGHT;
        }
        mNavBarTintView.setLayoutParams(params);
        mNavBarTintView.setBackgroundColor(DEFAULT_TINT_COLOR);
        mNavBarTintView.setVisibility(View.GONE);
        decorViewGroup.addView(mNavBarTintView);
    }

並沒有什麼難點，不過，讀者看到decor view group一直在addView，不會發生錯亂嗎？其實並不會，decor 是frame layout，當幫導航欄透明後，mNavBarTintView變回佈局到系統的導航欄後面，這時候用戶便可以看到自己定義的導航欄了