Android中如何收起状态栏

写在前面

这是一篇译文，原文自Android developer的Hiding the Status Bar，文中图片大都来自此网站，外链也将会链到android dev。
但并不是完全翻译，为方便表述有修改，带私货
转载请表明原文出处：http://www.jianshu.com/p/e14ceff34f85

效果

展示状态栏

收起状态栏

注：如果你将状态栏收起了，那么在一般情况下也应该把action bar给收起来。

在Android 4.0 及以前的版本收起状态栏

在Android 4.0（API level 14）及以前，你可以使用 设置WindowManager flag来收起状态栏。有两种方法可以实现这个目的：设置manifest文件中activity的theme或者是代码动态设置。

1、设置manifest文件中设置activity的theme

当然了，如果你希望你的app持续着状态栏收起的状态的话，那么设置activity的theme是最好的，下面是一个小栗子：

    ...

用这种方法的好处是显而易见的：

• 它更容易维护，且更难出错，因为它只修改了一处代码；
• 它能使UI过渡更平滑，因为在实例化你的activity以前系统就有了那些用于渲染UI的信息了；

2、代码动态修改WindowManager flag

直接上代码：

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // If the Android version is lower than Jellybean, use this call to hide
        // the status bar.
        if (Build.VERSION.SDK_INT < 16) {
            getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
                    WindowManager.LayoutParams.FLAG_FULLSCREEN);
        }
        setContentView(R.layout.activity_main);
    }
    ...
}

一旦你设置了WindowManager flags以后，flags的作用就会持续到你清除这些flags为止。
当你已经enable了 FLAG_FULLSCREEN以后， 你还可以通过设置 FLAG_LAYOUT_IN_SCREEN 来让你的activity 的layout使用那些可用的相同区域。这样当状态栏展示或隐藏的时候，activity中的UI大小也不会发生变化。

在Android 4.1 及更高的版本收起状态栏

在Android 4.1 （API level 16)你可以使用setSystemUiVisibility()方法来收起状态栏,setSystemUiVisibility()方法会在view的层别上来设置UI flags；这些设置会聚合到window层别。对比设置WindowManage flag 来说，使用setSystemUiVisibility()方法来设置UI flags的话，可以使你拥有对System bar有更细颗粒的控制（我们在想在哪个Activity、什么时候收起状态栏都行）。同样举个小栗子：

View decorView = getWindow().getDecorView();
// 隐藏状态栏的核心代码
int uiOptions = View.SYSTEM_UI_FLAG_FULLSCREEN;
decorView.setSystemUiVisibility(uiOptions);

// 如果隐藏了状态栏的话，记得也隐藏actionBar
ActionBar actionBar = getActionBar();
if(actionBar != null){  //此判断为译者增加
    actionBar.hide();
}

（附：你使用getActionBar获取ActionBar的话，有可能获取到一个null的ActionBar，因而为了安全，应该在hide操作之前验一下空）

注意事项：

• 一旦UI flags被clear掉了，你就应该重新设置这些flag。关于如何监听UI的可视化状态的改变，可参见Responding to UI Visibility Changes
• 你在不同的方法设置UI flags有可能导致不同的结果。如果你在activity的onCreate方法中设置UI flags的话，那么当你按下home键返回到桌面以后，那么状态栏就会重新出现，而当用户重新打开这个activity的时候，状态栏依旧显示。所以啊，如果你想用户回到这个activity的时候还是原来的隐藏状态栏的话，那么就应该在onResume()或者是onWindowFocusChanged()
• 在有你给出的view是可见的情况下，那该view调用setSystemUiVisibility()才是有效的（就是说调用这个方法的view必须是visible）
• 一旦一个view不在屏幕上了，那么在这个view上通过 setSystemUiVisibility()方法设置的flags都会被清除。（原文是Navigating away from the view causes flags set with setSystemUiVisibility() to be cleared.自行体会navigate away的意思，总感觉这个我翻译得不是很到位）

总结

那么根据上面的介绍，我们可以就写出两个静态方法了：

    public static void hideStatusBar(Activity activity){
        if (Build.VERSION.SDK_INT < 16) {
            activity.getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
                    WindowManager.LayoutParams.FLAG_FULLSCREEN);
        }
        else {
            View decorView = activity.getWindow().getDecorView();
            // Hide Status Bar.
            int uiOptions = View.SYSTEM_UI_FLAG_FULLSCREEN;
            decorView.setSystemUiVisibility(uiOptions);
        }
    }

    public static void showStatusBar(Activity activity){
        if (Build.VERSION.SDK_INT < 16) {
            activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
        }
        else {
            View decorView = activity.getWindow().getDecorView();
            // Show Status Bar.
            int uiOptions = View.SYSTEM_UI_FLAG_VISIBLE;
            decorView.setSystemUiVisibility(uiOptions);
        }
    }

代码很简单，也很容易用，我就不写文档了。但是我没有按着官方建议收起Action Bar，各位可以根据自己的需求来决定是否收起Action Bar：

// 如果隐藏了状态栏的话，记得也隐藏actionBar
ActionBar actionBar = getActionBar();
if(actionBar != null){  //此判断为译者增加
    actionBar.hide();
}

此外，也可以通过设置一个view的WindowManager flags来收起（/展示）状态栏:

view.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN); //收起状态栏
view.setSystemUiVisibility(View.SYSTEM_UI_FLAG_VISIBLE);    //展示状态栏

在状态栏的后面也设置内容

在Android 4.1 以后，你可以设置你app的内容展示到状态栏的后面，这样做的话，在状态栏被隐藏或展示以后，你的UI的大小也不会发生任何变化。为了达到这个目的，你可以使用 SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN标签，同时你可能也需要 SYSTEM_UI_FLAG_LAYOUT_STABLE标签来使得你的app维持一个稳定的layout状态.

如果你需要使用上面的这个方案，那么你就应当确保app的主要部分不会被System bar给遮挡住。有两种方法

• 在大多数的情况下，你可以在你的XML layout文件中，将android:fitsSystemWindows属性设置为true。这样做可以调整父ViewGroup的padding，使之留出空位来放置system windows。这个做法在大部分情况下就已经足够了。
• 然而在小部分的情况下，你仍需要手动修改默认的padding来适应，这时候需要重写 fitSystemWindows(Rect insets)方法（然而这个方法在API 20就被弃用了），我们就可以相对于System bar控制我们的UI布局了。（关于这个方法详细情况，可参见官方文档，解释得非常清楚）