Translucent System Bars-4.4新特性

概念

Google官方文档4.4APIs_KITKAT

该特性是在Android 4.4 KITKAT版本（API_19）中引入的新特性。

也就是我们说的 透明栏 ，国内一般称之为 沉浸式顶栏。在 Android 4.4 还是在 Android 5.0 +上, Translucent ｢透明｣ 的特质都能体现得非常清楚.

介绍

Android 4.4之前，我们打开手机app，总是能看到系统顶部那条黑乎乎的通知栏，显得非常不和谐。于是Android 4.4开始，便引入了Translucent System Bar的系特性，用于弥补系统通知栏突兀之处。

我们先来看看 Translucent System Bar 新特性引入后，发生了什么样的变化。




可以看到系统的通知栏和app界面融为一体。

两种实现方式

大致说明

工程目录：

注意事项

主要的操作都在style.xml 和 AndroidManifest.xml 中，Activity里面没有任何涉及到Translucent System Bar设置的代码，所以可以忽略不看。

ColorTranslucentBarActivity 和 ImageTranslucentBarActivity 分别用于展示两种不同实现方式的效果。 其中*2是继承TranslucentBarActitity2,在父类中设置了setFitsSystemWindows(true)属性，布局文件中可以省略了。

要在Activity中使用 Translucent System Bar 特性，首先需要到AndroidManifest中为指定的Activity设置Theme。但是需要注意的是，我们不能直接在values/style.xml直接去自定义 Translucet System Bar 的Theme，因为改特性仅兼容 Android 4.4 开始的平台，所以直接在values/style.xml声明引入，工程会报错。有些开发者朋友会在代码中去判断SDK的版本，然后再用代码设置Theme。虽然同样可以实现效果，但个人并不推崇这种做法。我所采取的方法则是建立多个SDK版本的values文件夹，系统会根据SDK的版本选择合适的Theme进行设置。大家可以看到上面我的工程里面有values、values-v19、values-v21。

背景图片延伸至系统栏

三步设置

第一步：设置不同版本下style.xml

在values、values-v19、values-v21的style.xml都设置一个 Translucent System Bar 风格的Theme。

values/style.xml

[code]  <style name="ImageTranslucentTheme" parent="AppTheme">
        <!--在Android 4.4之前的版本上运行，直接跟随系统主题-->
    </style>

values-v19/style.xml

[code]  <!--Android 4.4 -->

    <!--ImageTranslucentTheme-->
    <style name="ImageTranslucentTheme"  parent="Theme.AppCompat.Light.DarkActionBar">
        <item name="android:windowTranslucentStatus">true</item>
        <item name="android:windowTranslucentNavigation">true</item>
    </style>

values-v21/style.xml

[code] <!--Android 5.0以上版本-->

    <!--ImageTranslucentTheme-->
    <style name="ImageTranslucentTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <item name="android:windowTranslucentStatus">false</item>
        <item name="android:windowTranslucentNavigation">true</item>
        <!--Android 5.x开始需要把颜色设置透明，否则导航栏会呈现系统默认的浅灰色-->
        <item name="android:statusBarColor">@android:color/transparent</item>
    </style>

上面需要注意的地方是，无论你在哪个SDK版本的values目录下，设置了主题，都应该在最基本的values下设置一个同名的主题。这样才能确保你的app能够正常运行在 Android 4.4 以下的设备。否则，肯定会报找不到Theme的错误。

第二步：在AndroidManifest.xml中对指定Activity的theme进行设置

[code]   <!-- ImageTranslucentBarActivity -->
        <activity
            android:name=".translucentbar.ImageTranslucentBarActivity"
            android:label="@string/image_translucent_bar"
            android:theme="@style/ImageTranslucentTheme" />
        <!-- 第二种方式,在抽象类中通过代码的方式fitsSystemWindows=true -->
        <activity
            android:name=".translucentbar.ImageTranslucentBarActivity2"
            android:label="@string/image_translucent_bar"
            android:theme="@style/ImageTranslucentTheme" />

第三步：在Activity的布局文件中设置背景图片，同时，需要把android:fitsSystemWindows设置为true

[code]<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@mipmap/img"
    android:fitsSystemWindows="true">

    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="第一种方式继承父类BaseActivity的实现方式，布局文件根目录下需要设置fitsSystemWindows=true "
        android:textColor="@color/color_red"
        android:layout_margin="10dp"
        android:textSize="20sp" />

</RelativeLayout>

到此，第一种实现方式完成，系统栏会被背景图填充了。效果如下：

APP的Tab栏和系统导航栏分开来设置。

由于它的TAB栏是纯色的，所以只要把系统通知栏的颜色设置成和TAB栏一样的即可，实现方式上比第一种要简单的多。同样需要在不同SDK版本的values下，创建一个同名的Theme。

第一步 在不同SDK版本中的style.xml创建主题

values/style.xml

[code]  <style name="ColorTranslucentTheme" parent="AppTheme">
        <!--在Android 4.4之前的版本上运行，直接跟随系统主题-->
    </style>

values-v19/style.xml

[code]  <!--Android 4.4 -->

     <!--ColorTranslucentTheme-->
    <style name="ColorTranslucentTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <item name="android:windowTranslucentStatus">true</item>
        <item name="android:windowTranslucentNavigation">true</item>
    </style>

values-v21/style.xml

[code] <!--Android 5.0以上版本-->

  <!--ColorTranslucentTheme-->
    <style name="ColorTranslucentTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <item name="android:windowTranslucentStatus">false</item>
        <item name="android:windowTranslucentNavigation">true</item>
        <item name="android:statusBarColor">@color/color_31c27c</item>
    </style>

values-v21/style.xml中的android:statusBarColor，设置成透明色也可以实现相同的效果

[code] <item name="android:statusBarColor">@android:color/transparent</item>

第二步： ColorTranslucentBarActivity的布局文件activity_color_translucent_bar.xml中设置Tab栏的颜色

[code]<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true"
    android:orientation="vertical">

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="55dp"
        android:background="@color/color_31c27c">

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true"
            android:text="QQ Music"
            android:textColor="@android:color/white"
            android:textSize="20sp" />

    </RelativeLayout>
</LinearLayout>

说明： 上述设置话，会在真机上出现顶部变成黑白渐变的bug，建议采用下面的方式：

第一步：去到 ColorTranslucentBarActivity 的布局文件中，将布局划分成为标题布局和内容布局两部分；

第二步：将 ColorTranslucentBarActivity 的根布局颜色设置与标题布局的颜色一致，并将内容布局设置为白色；

[code]<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@color/color_31c27c"
    android:fitsSystemWindows="true"
    android:orientation="vertical">

    <!--标题布局-->
    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="55dp"
        android:background="@color/color_31c27c">

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true"
            android:text="QQ Music"
            android:textColor="@android:color/white"
            android:textSize="20sp" />

    </RelativeLayout>

    <!--内容布局-->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:background="@android:color/white"
        android:orientation="vertical">

        <Button
            android:id="@+id/btn_show_toast"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:text="Show a toast" />
    </LinearLayout>

</LinearLayout>

第三步：Manifest.xml中为Activity设置主题

[code]
        <!-- ColorTranslucentBarActivity -->
        <activity
            android:name=".translucentbar.ColorTranslucentBarActivity"
            android:label="@string/color_translucent_bar"
            android:theme="@style/ColorTranslucentTheme" />

至此，第二种的方式所有的操作步骤已经完成，效果如下：

注意事项

android:fitsSystemWindows说明

设置布局调整时是否考虑系统窗口（如状态栏）

通过前面的两种方式，大家估计会留意到一个地方，就是所有实现 Translucent System Bar 效果的Activity，都需要在根布局里设置 android:fitsSystemWindows=”true” 。设置了该属性的作用在于，不会让系统导航栏和我们app的UI重叠，导致交互问题。

设置的效果：



不设置的效果：



想必区别就不用多说了吧。

避免重复设置android:fitsSystemWindows

上述写法，如果有多个Activity要实现这种效果，就要在每一个布局文件中设置fitSsytemWindows属性，非常繁琐切容易忘记。

尝试方案：

一 ：在theme中加上如下的android:fitsSystemWindows设置：

[code]<item name="android:fitsSystemWindows">true</item>

虽然效果上可以实现。但是在布局文件中设置是对View生效，而到了theme进行设置则是对Window生效，会影响到其他组件的位置，比如Toast中的文字会上移等等，所以这种方法不可取。



第二种尝试： 在代码中设置。

避免在每个布局文件中都要写上 android:fitsSystemWindows=”true”，可以在抽象父类中设置即可。

[code]
import android.os.Build;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.View;
import android.view.ViewGroup;
import android.view.Window;

/**
 * MyApp
 *
 * @author Mr.Yang on 2016-02-26  09:32.
 * @version 1.0
 * @desc TranslucentBarBaseActivity 抽象类 ，
 * 继承此类，可以避免在每个布局文件中写 android:fitsSystemWindows="true"
 */
public abstract class TranslucentBarBaseActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 取消标题
        supportRequestWindowFeature(Window.FEATURE_NO_TITLE);
        // 将设置布局文件的操作交给继承的子类
        setContentView(getLayoutResId());

        // 设置android:fitsSystemWindows="true"属性
        ViewGroup contentFrameLayout = (ViewGroup) findViewById(Window.ID_ANDROID_CONTENT);
        View parentView = contentFrameLayout.getChildAt(0);
        if (parentView != null && Build.VERSION.SDK_INT >= 19) {
            Log.d("TBBActivity", "SDK_INT:" + Build.VERSION.SDK_INT);
            parentView.setFitsSystemWindows(true);
        }
    }

    /**
     * 定义成抽象方法,子类继承此父类抽象类，必须重写
     *
     * @return
     */
    protected abstract int getLayoutResId();

}

所有需要实现效果的界面继承TranslucentBarBaseActivity 父类，并实现 getLayoutResId 抽象方法即可，就可以不用在布局文件中不断做重复操作了。

总结

方式一适用于app中没有导航栏，且整体的背景是一张图片的界面；

方式二适用于app中导航栏颜色为纯色的界面；

android:fitsSystemWindows设置要在布局文件中，不要到theme中设置,或者在抽象类中设置，子类继承抽象类即可。

参考文章：

http://www.jianshu.com/p/0acc12c29c1b#

感谢D_clock