android 状态栏透明效果

测试设备：vivo android10，小米 android13
使用主题：Theme.Material3.DayNight.NoActionBar
Activity父类：AppCompatActivity
布局文件需注意添加：android:fitsSystemWindows="true"，完整的布局文件在下文
参考文档：fitsSystemWindows 参考文档

window.clearFlags(
                WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS
                        or WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION
            )
window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
window.statusBarColor = Color.TRANSPARENT

里面过时api的处理

        // 过时，官方文档说使用 window.statusBarColor = Color.TRANSPARENT,
        // https://developer.android.google.cn/reference/kotlin/android/view/WindowManager.LayoutParams?hl=en#flag_translucent_status
        // 由于测试手机是 TIRAMISU，为保险就使用 TIRAMISU
        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
            window.clearFlags(
                WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS
                        or WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION
            )
        }
        // SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN：https://developer.android.google.cn/reference/kotlin/android/view/View?hl=en#system_ui_flag_layout_fullscreen
        // SYSTEM_UI_FLAG_LAYOUT_STABLE 未提供相应替代方案，不过不用好像也没问题：https://developer.android.google.cn/reference/kotlin/android/view/View?hl=en#system_ui_flag_layout_stable
        // 由于测试手机是 TIRAMISU，为保险就使用 TIRAMISU
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            window.setDecorFitsSystemWindows(false)
        } else {
            window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
        }
        window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
        window.statusBarColor = Color.TRANSPARENT

怀疑里面是否有冗余的代码调用，测试后发现可简化为：

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            window.setDecorFitsSystemWindows(false)
        } else {
            window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
        }
        window.statusBarColor = Color.TRANSPARENT

注意：如果使用上面这段代码，并且在主题里面设置了 <item name="android:windowTranslucentStatus">true</item> 后，在安android10上的状态栏是半透明的，而在android13上是全透明。Translucent 本意就是半透明，但是 windowTranslucentStatus 在android13上的效果是全透明。

如果不介意部分手机(android13以下)状态栏是半透明的话，仅配置主题就好了，比如：

    <style name="Base.Theme.Docker" parent="Theme.Material3.DayNight.NoActionBar">
        <item name="android:windowTranslucentStatus">true</item>
    </style>

android:fitsSystemWindows="true"的作用，测试后推断所得

• 透明状态栏的情况下，确保当前控件的位置在最顶部
• 确保内部控件，不被状态栏挡住（不管是否是在透明状态栏的情况下）

据说该属性在一些控件不生效，我测试的布局文件是(没错，fitsSystemWindows属性放在ImageView里面的)：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout 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.opengl.GLSurfaceView
        android:id="@+id/surfaceView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

    <ImageView
        android:id="@+id/moreBtn"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@android:drawable/ic_dialog_dialer"
        android:fitsSystemWindows="true"
        android:layout_marginEnd="10dp"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        android:gravity="bottom|center_horizontal">

        <Button
            android:id="@+id/editBtn"
            android:layout_width="200dp"
            android:layout_height="wrap_content"
            android:layout_marginBottom="20dp"
            android:text="修改参数" />

        <Button
            android:id="@+id/applyBtn"
            android:layout_width="200dp"
            android:layout_height="wrap_content"
            android:text="设置为壁纸"
            android:layout_marginBottom="50dp"/>

    </LinearLayout>

</androidx.constraintlayout.widget.ConstraintLayout>