Android 实现完全透明状态栏的终极指南：步步详解

2024-03-18 15:21:56

Android 中实现完全透明状态栏的终极指南

简介

在 Android 开发中，透明状态栏常常被忽视或遗漏。尽管在 Android 4.4 中首次引入，但实现透明状态栏仍然是一项艰巨的挑战。本指南将详细介绍如何在 Android 应用中实现完全透明状态栏，同时向下兼容到 API 19。

步骤

1. 设置窗口标志

在 AndroidManifest.xml 中设置窗口标志，允许应用在状态栏后方绘制。

<activity
    android:name=".MainActivity"
    android:label="@string/app_name"
    android:theme="@style/AppTheme"
    android:windowTranslucentStatus="true"
    android:windowTranslucentNavigation="true">
</activity>

2. 创建自定义主题

在 styles.xml 中创建一个自定义主题，应用于应用。该主题包含透明状态栏的设置。

<resources>

    <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
        <item name="android:statusBarColor">@android:color/transparent</item>
        <item name="android:windowTranslucentStatus">true</item>
    </style>

</resources>

3. 使用沉浸式模式（可选）

沉浸式模式隐藏导航栏和状态栏，提供全屏显示效果。

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // 启用沉浸式模式
    View decorView = getWindow().getDecorView();
    decorView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_IMMERSIVE | View.SYSTEM_UI_FLAG_LAYOUT_STABLE | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION);
}

4. 向下兼容性

为了兼容 API 19，请使用 setStatusBarColor 方法。

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    // API 21+
    window.setStatusBarColor(Color.TRANSPARENT);
} else {
    // API 19-20
    window.addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
}