Android透明狀態(tài)欄總結(jié)

去年曾對(duì)狀態(tài)欄進(jìn)行了一次總結(jié)，具體見安卓自定義StatusBar-布局內(nèi)容延展及沉浸式狀態(tài)欄實(shí)現(xiàn)所宰。近期再一次做透明狀態(tài)欄相關(guān)的工作，加深了對(duì)狀態(tài)欄的理解。所以決定再做一次總結(jié)菇晃，爭取能做到通熟易懂。

先提幾個(gè)關(guān)鍵詞蚓挤。Transparent（透明的）磺送、Translucent（半透明）、Immersive（沉浸式）

首先聊下沉浸式這個(gè)詞灿意，它指給用戶提供完全沉浸的體驗(yàn)估灿。沉浸式狀態(tài)欄的叫法是錯(cuò)誤的，應(yīng)該是一種沉浸式的模式缤剧。它要求隱藏狀態(tài)欄馅袁，使屏幕全屏，常應(yīng)用在游戲鞭执，視頻播放場景司顿。具體可參考郭霖的博客Android狀態(tài)欄微技巧，帶你真正理解沉浸式模式.

關(guān)于狀態(tài)欄兄纺，比較常見的效果如下：

圖1

圖2

設(shè)置狀態(tài)欄顏色

圖1和圖2的狀態(tài)欄顏色不同大溜。實(shí)現(xiàn)的思路如下：
1、android 5.0及以上版本

window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
window.setStatusBarColor(int);

其中估脆，5.0版本的FLAG_TRANSLUCENT_STATUS是全透明的钦奋，但是6.0上卻是半透明的。若要實(shí)現(xiàn)圖1的效果，則需要直接設(shè)置statusbar的顏色付材。
2朦拖、android 4.4版本
通過設(shè)置狀態(tài)欄為透明，將應(yīng)用布局延展到狀態(tài)欄下面厌衔。然后在布局里構(gòu)造一個(gè)同狀態(tài)欄同尺寸的view璧帝，對(duì)view設(shè)置背景顏色即可。

//設(shè)置透明狀態(tài)欄
window.addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
//取消透明狀態(tài)欄
window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);

注意富寿，4.4版本的透明效果如下圖睬隶，頂部有一個(gè)黑色的半透明過渡。

image.png

實(shí)現(xiàn)代碼如下：

/**
     * 設(shè)置狀態(tài)欄顏色
     *
     * @param activity       需要設(shè)置的activity
     * @param color          狀態(tài)欄顏色值
     * @param statusBarAlpha 狀態(tài)欄透明度
     */

    public static void setColor(Activity activity, @ColorInt int color, @IntRange(from = 0, to = 255) int statusBarAlpha) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            //
            activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
            //取消透明狀態(tài)欄页徐，contentView不再與狀態(tài)欄重疊
            activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
            activity.getWindow().setStatusBarColor(calculateStatusColor(color, statusBarAlpha));
        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            //透明狀態(tài)欄苏潜，contentView與狀態(tài)欄重疊，需使用fitSystemWindow屬性
            activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
            ViewGroup decorView = (ViewGroup) activity.getWindow().getDecorView();
            View fakeStatusBarView = decorView.findViewById(FAKE_STATUS_BAR_VIEW_ID);
            if (fakeStatusBarView != null) {
                if (fakeStatusBarView.getVisibility() == View.GONE) {
                    fakeStatusBarView.setVisibility(View.VISIBLE);
                }
                fakeStatusBarView.setBackgroundColor(calculateStatusColor(color, statusBarAlpha));
            } else {
                decorView.addView(createStatusBarView(activity, color, statusBarAlpha));
            }
            setRootView(activity);
        }
    }

/**
     * 生成一個(gè)和狀態(tài)欄大小相同的半透明矩形條
     *
     * @param activity 需要設(shè)置的activity
     * @param color    狀態(tài)欄顏色值
     * @param alpha    透明值
     * @return 狀態(tài)欄矩形條
     */
    private static View createStatusBarView(Activity activity, @ColorInt int color, int alpha) {
        // 繪制一個(gè)和狀態(tài)欄一樣高的矩形
        View statusBarView = new View(activity);
        LinearLayout.LayoutParams params =
            new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, getStatusBarHeight(activity));
        statusBarView.setLayoutParams(params);
        statusBarView.setBackgroundColor(calculateStatusColor(color, alpha));
        statusBarView.setId(FAKE_STATUS_BAR_VIEW_ID);
        return statusBarView;
    }

布局延展至狀態(tài)欄

1变勇、android 5.0及以上版本
使用setSystemUiVisibility方法恤左，設(shè)置View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN和View.SYSTEM_UI_FLAG_LAYOUT_STABLE。

//代碼配置
activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);
activity.getWindow().setStatusBarColor(Color.TRANSPARENT);
activity.getWindow().getDecorView().setSystemUiVisibility(
        View.SYSTEM_UI_FLAG_LAYOUT_STABLE
                | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
                | SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION

);

//xml配置：values-v21/styles.xml中主題增加以下內(nèi)容
<style name="fullScreenTheme" parent="Theme.AppCompat.Light.DarkActionBar">
    <item name="android:windowTranslucentStatus">false</item>
    <item name="android:windowTranslucentNavigation">true</item>
    <item name="android:statusBarColor">@android:color/transparent</item>
</style>

避免使用WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS屬性搀绣，以提高體驗(yàn)飞袋，解決6.0系統(tǒng)的兼容性問題

6.0系統(tǒng)半透明狀態(tài)欄

2、android 4.4版本

window.addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);

上述的兩個(gè)步驟链患，針對(duì)下圖中圖片延展到狀態(tài)欄授嘀，能完全滿足需求。

圖片延展

但針對(duì)一些布局延展锣险，則需要額外處理來解決布局內(nèi)容和狀態(tài)欄區(qū)域覆蓋的問題。一般的做法是使用fitSystemWindow屬性

fitSystemWindow

可以通過java代碼或xml來配置览闰。
1芯肤、view的fitsSystemWindows設(shè)置為true后，系統(tǒng)會(huì)調(diào)整view的padding來給statusbar留出空間压鉴，padding的值與statusbar的高度相同崖咨。如果該view設(shè)置了背景色，則狀態(tài)欄顯示與view一致的背景色油吭。若view未設(shè)置背景色击蹲，則會(huì)顯示activity默認(rèn)的背景色（theme中指定）；如果activity移除了默認(rèn)背景色婉宰，則狀態(tài)欄會(huì)顯示黑色歌豺。
2、如果是activity中包含fragment心包，則需要在fragment的內(nèi)容中設(shè)置fitsSystemWindows屬性类咧。
3、建議在xml中進(jìn)行靈活配置。如果通過theme或代碼直接設(shè)置第一個(gè)子view的fitSystemWindows屬性痕惋，容易出現(xiàn)問題区宇。
4、多個(gè)view設(shè)置該屬性時(shí)值戳，一般只有第一個(gè)view生效议谷。

默認(rèn)背景色

可通過在style中設(shè)置windowBackground屬性或java代碼設(shè)置activity的默認(rèn)背景色。系統(tǒng)提供的theme中堕虹，通過windowBackground設(shè)置了默認(rèn)背景色卧晓。

//xml中設(shè)置
<item name="android:windowBackground">@color/white</item>

//java代碼設(shè)置
getWindow().setBackgroundDrawable(drawable)

一般情況下，不推薦對(duì)activity設(shè)置默認(rèn)背景鲫凶。因activity的布局中一般有自己的背景色禀崖，添加window的背景色容易造成overdraw降低性能。一般使用getWindow().setBackgroundDrawable(null)或者xml中設(shè)置android:windowbackground="null" 刪除window的背景色螟炫。但有以下注意事項(xiàng)波附。
1.這句代碼必須要在setContentView()方法之后調(diào)用。
否則在頁面未布局前昼钻，會(huì)出現(xiàn)一閃而過的黑影掸屡，影響用戶體驗(yàn)。

2.若activity的父布局未設(shè)置背景然评，會(huì)出現(xiàn)沒有子view的空白部分出現(xiàn)黑色仅财。甚至在webview的使用時(shí)，出現(xiàn)滑動(dòng)顯示繪制異常的問題碗淌。建議給布局設(shè)置一個(gè)背景盏求。

狀態(tài)欄默認(rèn)顏色

通過在theme中設(shè)置colorPrimaryDark。注意亿眠，在android 5.0之后才能進(jìn)行該屬性設(shè)置

<item name="colorPrimaryDark">@android:color/black</item>

下圖可參考幾個(gè)關(guān)鍵color屬性的影響位置碎罚。