这是一个为Android App 设置状态栏的工具类， 可以在4.4及其以上系统中实现 沉浸式状态栏/状态栏变色，支持设置状态栏透明度，满足你司设计师的各种要求(雾)。

在此之前我写过一篇Android App 沉浸式状态栏解决方案，后来我司设计师说默认的透明度太深了，让我改浅一点，然后在想了一些办法之后给解决了。本着不重复造轮子的原则，索性整理成一个工具类，方便需要的开发者。

项目 GitHub 地址

Sample 下载

下载 StatusBarUtil-Demo

特性

  1. 设置状态栏颜色

    StatusBarUtil.setColor(Activity activity, int color)

  2. 设置状态栏半透明

    StatusBarUtil.setTranslucent(Activity activity, int statusBarAlpha)

    ​​

  3. 设置状态栏全透明

    StatusBarUtil.setTransparent(Activity activity)

  4. 为包含 DrawerLayout 的界面设置状态栏颜色（也可以设置半透明和全透明）

    StatusBarUtil.setColorForDrawerLayout(Activity activity, DrawerLayout drawerLayout, int color)

  5. 为使用 ImageView 作为头部的界面设置状态栏透明

    StatusBarUtil.setTranslucentForImageView(Activity activity, int statusBarAlpha, View needOffsetView)

  6. 在 Fragment 中使用

  7. 为滑动返回界面设置状态栏颜色

    推荐配合 bingoogolapple/BGASwipeBackLayout-Android: Android Activity 滑动返回 这个库一起使用。

    StatusBarUtil.setColorForSwipeBack(Activity activity, @ColorInt int color, int statusBarAlpha)

  8. 通过传入 statusBarAlpha 参数，可以改变状态栏的透明度值，默认值是112。

使用

  1. 在 build.gradle 文件中添加依赖, StatusBarUtil 已经发布在 JCenter:

    compile 'com.jaeger.statusbarutil:library:1.4.0'

  2. 在 setContentView() 之后调用你需要的方法，例如:

    setContentView(R.layout.main_activity);
...
StatusBarUtil.setColor(MainActivity.this, mColor);

  3. 如果你在一个包含 DrawerLayout 的界面中使用, 你需要在布局文件中为 DrawerLayout 添加 android:fitsSystemWindows="true" 属性:

    
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/drawer_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true">

    ...

  4. 滑动返回界面设置状态栏颜色：

    建议配合 bingoogolapple/BGASwipeBackLayout-Android: Android Activity 滑动返回 库一起使用。

    StatusBarUtil.setColorForSwipeBack(Activity activity, @ColorInt int color, int statusBarAlpha)

  5. 当你设置了 statusBarAlpha 值时，该值需要在 0 ~ 255 之间

  6. 在 Fragment 中的使用可以参照 UseInFragmentActivity.java 来实现

更新日志

  • 1.4.0

    • 修改拼写错误

  • 1.3.6

    • bug fix
  • 1.3.5
    • 添加 hideFakeStatusBarView 方法来隐藏假的状态栏 View
  • 1.3.4
  • 1.3.3
    • 修复 setColorForSwipeBack 方法和 CoordinatorLayout 一起使用的 bug
  • 1.3.2
    • 修复 bug

  • 1.3.1

    • bug 修复

  • 1.3.0

    • 完善 setColor 逻辑，避免潜在的问题

  • 1.2.8

    • 修复 setColorDiff 方法中的一个 bug

  • 1.2.7

    • 新增 setColorForSwipeBack 方法，支持滑动返回，目前支持的滑动返回库有：

      • r0adkll/Slidr
      • bingoogolapple/BGASwipeBackLayout

  • 1.2.6

    • 升级 support 包到 24.2.1 版本

  • 1.2.5

    • 添加 @ColorInt 注解，现在如果传入 R.color.xx，就会提示使用错误
    • 修复 DrawerLayout 内容布局设置 paddding 失效的 bug

  • 1.2.4

    • 修复 setTranslucentForImageViewInFragment() 方法的一个 bug

  • 1.2.3

    • 修复 setTranslucentForImageView ，现在支持传 null 作为 needOffsetView 的值

    • 新增当 fragment 头部是 ImageView 时设置透明状态栏的方法

      setTranslucentForImageViewInFragment(Activity activity, View needOffsetView)
setTransparentForImageViewInFragment(Activity activity, View needOffsetView)

    • 修复根布局是 CoordinatorLayout 时设置状态栏全透明和半透明的 bug

      setTranslucentForCoordinatorLayout(Activity activity, int statusBarAlpha)

  • 1.2.0

    支持为使用 ImageView 作为头部的界面设置状态栏透明

  • 1.1.1

    修复部分 4.4 上的 bug

  • 1.1.0

    修复 bug

最后

如果你有任何建议或问题，请及时联系我。如果你对这个工具类有优化，欢迎 fork 提 pr。

传送门 GitHub 地址

搭个梯子，去看看墙外的世界(超低价，亲测稳定、速度快)