测试设备: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>