kinghom/ImmersionBar

android 4.4以上沉浸式状态栏和沉浸式导航栏管理，一句代码轻松实现，以及对bar的其他设置，详见README，http://www.jianshu.com/p/2a884e211a62

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.kinghom:ImmersionBar:'
	}

	dependencies {
		implementation("com.github.kinghom:ImmersionBar:")
	}

	<dependency>
	    <groupId>com.github.kinghom</groupId>
	    <artifactId>ImmersionBar</artifactId>
	    <version></version>
	</dependency>


                            
    libraryDependencies += "com.github.kinghom" % "ImmersionBar" % ""


                            
    :dependencies [[com.github.kinghom/ImmersionBar ""]]

Readme

ImmersionBar -- android 4.4以上沉浸式实现

直接看效果图，最下面有各个版本的效果图

使用

android studio

compile 'com.gyf.barlibrary:barlibrary:2.2.2'

eclipse

barlibrary-2.2.2.jar

版本说明

点我

下载demo

下载

用法

初始化

基础用法（已经可以满足日常沉浸式）
```
ImmersionBar.with(this).init();
```

高级用法(每个参数的意义)

ImmersionBar.with(this)
             .transparentStatusBar()  //透明状态栏，不写默认透明色
             .transparentNavigationBar()  //透明导航栏，不写默认黑色(设置此方法，fullScreen()方法自动为true)
             .transparentBar()             //透明状态栏和导航栏，不写默认状态栏为透明色，导航栏为黑色（设置此方法，fullScreen()方法自动为true）
             .statusBarColor(R.color.colorPrimary)     //状态栏颜色，不写默认透明色
             .navigationBarColor(R.color.colorPrimary) //导航栏颜色，不写默认黑色
             .barColor(R.color.colorPrimary)  //同时自定义状态栏和导航栏颜色，不写默认状态栏为透明色，导航栏为黑色
             .statusBarAlpha(0.3f)  //状态栏透明度，不写默认0.0f
             .navigationBarAlpha(0.4f)  //导航栏透明度，不写默认0.0F
             .barAlpha(0.3f)  //状态栏和导航栏透明度，不写默认0.0f
             .statusBarDarkFont(true)   //状态栏字体是深色，不写默认为亮色
             .flymeOSStatusBarFontColor(R.color.btn3)  //修改flyme OS状态栏字体颜色
             .fullScreen(true)      //有导航栏的情况下，activity全屏显示，也就是activity最下面被导航栏覆盖，不写默认非全屏
             .hideBar(BarHide.FLAG_HIDE_BAR)  //隐藏状态栏或导航栏或两者，不写默认不隐藏
             .setViewSupportTransformColor(toolbar) //设置支持view变色，支持一个view，不指定颜色，默认和状态栏同色，还有两个重载方法
             .addViewSupportTransformColor(toolbar)  //设置支持view变色，可以添加多个view，不指定颜色，默认和状态栏同色，还有两个重载方法
             .titleBar(view)    //解决状态栏和布局重叠问题，任选其一
             .statusBarView(view)  //解决状态栏和布局重叠问题，任选其一
             .fitsSystemWindows(true)    //解决状态栏和布局重叠问题，任选其一，默认为false，当为true时一定要指定statusBarColor()，不然状态栏为透明色
             .supportActionBar(true) //支持ActionBar使用
             .statusBarColorTransform(R.color.orange)  //状态栏变色后的颜色
             .navigationBarColorTransform(R.color.orange) //导航栏变色后的颜色
             .barColorTransform(R.color.orange)  //状态栏和导航栏变色后的颜色
             .removeSupportView()  //移除通过setViewSupportTransformColor()方法指定的view
             .removeSupportView(toolbar)  //移除指定view支持
             .removeSupportAllView() //移除全部view支持
             .init();  //必须调用方可沉浸式

关闭销毁

在activity的onDestroy方法中执行

ImmersionBar.with(this).destroy(); //不调用该方法，如果界面bar发生改变，在不关闭app的情况下，退出此界面再进入将记忆最后一次bar改变的状态

建议

建议在BaseActivity中初始化和销毁

public class BaseActivity extends AppCompatActivity {
     @Override
     protected void onCreate(@Nullable Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         ImmersionBar.with(this).init();
     }

     @Override
     protected void onDestroy() {
         super.onDestroy();
         ImmersionBar.with(this).destroy();  //不调用该方法，如果界面bar发生改变，在不关闭app的情况下，退出此界面再进入将记忆最后一次bar改变的状态
     }
}

在Fragment中的用法（fragment+viewpager）

为了使每个fragment都可以设置不同的沉浸式样式，这里给出两种解决方式，这两种实现效果都一样的

①使用viewpager的addOnPageChangeListener方法，代码如下

 viewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
         @Override
         public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
             switch (position) {
                 case 0:
                     ImmersionBar.with(oneFragment)
                             .navigationBarColor(R.color.btn4)
                             .init();
                     break;
                 case 1:
                     ImmersionBar.with(twoFragment)
                             .statusBarDarkFont(true)
                             .navigationBarColor(R.color.btn3)
                             .init();
                     break;
                 case 2:
                     ImmersionBar.with(threeFragment)
                             .navigationBarColor(R.color.btn13)
                             .init();
                     break;
                 case 3:
                     ImmersionBar.with(fourFragment)
                             .statusBarDarkFont(true)
                             .navigationBarColor(R.color.btn1)
                             .init();
                     break;
             }
         }

         @Override
         public void onPageSelected(int position) {

         }

         @Override
         public void onPageScrollStateChanged(int state) {

         }
     });

②继承ImmersionFragment类，在immersionInit中初始化沉浸式，代码如下：

public class OneFragment extends ImmersionFragment {
     @Nullable
     @Override
        public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
            return inflater.inflate(R.layout.fragment_one, container, false);
        }
        @Override
        protected void immersionInit() {
            ImmersionBar.with(this)
                    .statusBarDarkFont(false)
                    .navigationBarColor(R.color.btn4)
                    .init();
        }
    }

状态栏与布局顶部重叠解决方案，五种方案任选其一

① 使用dimen自定义状态栏高度

在values-v19/dimens.xml文件下

    <dimen name="status_bar_height">25dp</dimen>

在values/dimens.xml文件下

    <dimen name="status_bar_height">0dp</dimen>

然后在布局界面添加view标签，高度指定为status_bar_height

 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:app="http://schemas.android.com/apk/res-auto"
       android:layout_width="match_parent"
       android:layout_height="match_parent"
       android:background="@color/darker_gray"
       android:orientation="vertical">

       <View
           android:layout_width="match_parent"
           android:layout_height="@dimen/status_bar_height"
           android:background="@color/colorPrimary" />

       <android.support.v7.widget.Toolbar
           android:layout_width="match_parent"
           android:layout_height="wrap_content"
           android:background="@color/colorPrimary"
           app:title="方法一"
           app:titleTextColor="@android:color/white" />
 </LinearLayout>

② 使用系统的fitsSystemWindows属性，要慎用，会有意想不到的坑

  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        android:fitsSystemWindows="true">
  </LinearLayout>

然后使用ImmersionBar时候必须指定状态栏颜色

  ImmersionBar.with(this)
         .statusBarColor(R.color.colorPrimary)
         .init();

③ 使用ImmersionBar的fitsSystemWindows(boolean fits)方法

    ImmersionBar.with(this)
        .statusBarColor(R.color.colorPrimary)
        .fitsSystemWindows(true)  //使用该属性必须指定状态栏的颜色，不然状态栏透明，很难看
        .init();

④ 使用ImmersionBar的statusBarView(View view)方法

在标题栏的上方增加View标签，高度指定为0dp

    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
           xmlns:app="http://schemas.android.com/apk/res-auto"
           android:layout_width="match_parent"
           android:layout_height="match_parent"
           android:background="@color/darker_gray"
           android:orientation="vertical">

           <View
               android:layout_width="match_parent"
               android:layout_height="0dp"
               android:background="@color/colorPrimary" />

           <android.support.v7.widget.Toolbar
               android:layout_width="match_parent"
               android:layout_height="wrap_content"
               android:background="@color/colorPrimary"
               app:title="方法四"
               app:titleTextColor="@android:color/white" />
    </LinearLayout>

然后使用ImmersionBar的statusBarView方法，指定view就可以啦

     ImmersionBar.with(this)
           .statusBarView(view)
           .init();

⑤ 使用ImmersionBar的titleBar(View view)方法

         ImmersionBar.with(this)
               .titleBar(view) //指定标题栏view
               .init();

解决EditText和软键盘的问题

      KeyboardPatch.patch(this, linearLayout).enable(); //解决底部EditText和软键盘的问题，linearLayout指的是当前布局的根节点

当白色背景状态栏遇到不能改变状态栏字体为深色的设备时，解决方案

      ImmersionBar.with(this)
                  .statusBarDarkFont(true, 0.2f)
                  .init();

状态栏和导航栏其它方法

public static boolean hasNavigationBar(Activity activity)

判断是否存在导航栏
public static int getNavigationBarHeight(Activity activity)

获得导航栏的高度
public static int getNavigationBarWidth(Activity activity)

获得导航栏的宽度
public static boolean isNavigationAtBottom(Activity activity)

判断导航栏是否在底部
public static int getStatusBarHeight(Activity activity)

或得状态栏的高度
public static int getActionBarHeight(Activity activity)

或得ActionBar得高度

效果图

说明

这是状态栏
这是导航栏（有些手机没有导航栏）

动态图
android 6.0 有导航栏效果 <img width="300" src="https://github.com/gyf-dev/Screenshots/blob/master/ImmersionBar/Screenshot_6.0.gif"/>
android 4.4 有导航栏效果 <img width="300" src="https://github.com/gyf-dev/Screenshots/blob/master/ImmersionBar/Screenshot_4.4.gif"/>
android 4.4 没有导航栏效果 <img width="300" src="https://github.com/gyf-dev/Screenshots/blob/master/ImmersionBar/Screenshot_4.4_no.gif"/>

特别鸣谢

感谢zhangzhen92远程协助测试

联系我

QQ群 314360549（沉浸式交流）
WeChat(微信) <img width="300" src="https://github.com/gyf-dev/Screenshots/blob/master/ImmersionBar/wechat.JPG"/>