Android 中如何收起状态栏

写在前面

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

效果

《Android 中如何收起状态栏》

展示状态栏
《Android 中如何收起状态栏》

收起状态栏

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

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

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

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

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

<application
    ...
    android:theme="@android:style/Theme.Holo.NoActionBar.Fullscreen" >
    ...
</application>

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

  • 它更容易维护,且更难出错,因为它只修改了一处代码;
  • 它能使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布局了。(关于这个方法详细情况,可参见官方文档,解释得非常清楚)
    原文作者:Android
    原文地址: https://juejin.im/entry/58f22966ac502e006c2981a2
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞