ImmersionBar

![logo](https://github.com/gyf-dev/Screenshots/blob/master/ImmersionBar/readme_head.png)
# ImmersionBar -- android 4.4以上沉浸式实现 
[![version](https://img.shields.io/badge/version-3.3.3-brightgreen.svg)](https://central.sonatype.com/artifact/com.geyifeng.immersionbar/immersionbar) [![author](https://img.shields.io/badge/author-gyf--dev-orange.svg)](https://github.com/gyf-dev) [![简书](https://img.shields.io/badge/%E7%AE%80%E4%B9%A6-HeLe%E5%B0%8F%E5%AD%90%E6%8B%BD-blue.svg)](https://www.jianshu.com/p/2a884e211a62) [![QQ群](https://img.shields.io/badge/QQ%E7%BE%A4-314360549-red.svg)]()

## 直接看效果图，建议下载demo体验，最下面有各个版本的效果图
<img width="300"  src="https://github.com/gyf-dev/Screenshots/blob/master/ImmersionBar/Screenshot_6.0.gif"/>

## 使用（gyf替换为geyifeng） 
> 3.1.1以上版本(mavenCentral)
   ```groovy
   // 基础依赖包，必须要依赖
   implementation 'com.geyifeng.immersionbar:immersionbar:3.3.3'
   // kotlin扩展（可选）
   implementation 'com.geyifeng.immersionbar:immersionbar-ktx:3.3.3'
   // fragment快速实现（可选）已废弃
   implementation 'com.geyifeng.immersionbar:immersionbar-components:3.3.3'
   ```
> 3.0.0版本(jcenter)
   ```groovy
   // 基础依赖包，必须要依赖
   implementation 'com.gyf.immersionbar:immersionbar:3.0.0'
   // kotlin扩展（可选）
   implementation 'com.gyf.immersionbar:immersionbar-ktx:3.0.0'
   // fragment快速实现（可选）
   implementation 'com.gyf.immersionbar:immersionbar-components:3.0.0'
   ```

## 版本说明
#### [点我查看版本说明](https://github.com/gyf-dev/ImmersionBar/wiki)

## 下载demo 
#### [点我下载immersionBar-3.3.3.apk](https://github.com/gyf-dev/ImmersionBar/blob/master/apk/immersionbar-3.3.3.apk)

## 关于全面屏与刘海
#### 关于全面屏
   在manifest加入如下配置，四选其一，或者都写

   ① 升级targetSdkVersion为25以上版本，现在基本都是25以上了，所以以下三个没有必要配置了

   ② 在manifest的Application节点中加入
   ```xml
      android:resizeableActivity="true"
   ```
   ③ 在manifest的Application节点中加入
   ```xml
      android:maxAspectRatio="2.4"
   ```
   ④ 在manifest的Application节点下加入
   ```xml
      <meta-data 
        android:name="android.max_aspect"
        android:value="2.4" />
   ```

#### 关于刘海屏 
  在manifest的Application节点下加入，vivo和oppo没有找到相关配置信息
   ```xml
      <!--适配华为（huawei）刘海屏-->
      <meta-data 
        android:name="android.notch_support" 
        android:value="true"/>
      <!--适配小米（xiaomi）刘海屏-->
      <meta-data
        android:name="notch.config"
        android:value="portrait|landscape" />
   ```
  
## Api详解
- 基础用法

    ```java
    ImmersionBar.with(this).init();
    ```
- 高级用法(每个参数的意义)

    ```java
     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