Android 11及以上设备深色状态栏无法隐藏的解决方案求助

针对你遇到的Android 12及以上设备状态栏仍显示深色的问题，以下是经过测试的修复方案，围绕系统栏背景控制、WebView布局适配两个核心点调整：

一、修正主题配置 #

在FullScreenTheme中补充关键属性，阻止系统自动渲染状态栏深色背景：

<style name="FullScreenTheme" parent="Theme.AppCompat.NoActionBar">
    <!-- 保留原有属性 -->
    <item name="windowActionBar">false</item>
    <item name="windowNoTitle">true</item>
    <item name="android:colorBackground">@null</item>
    <item name="android:windowBackground">@null</item>
    <item name="background">@null</item>
    <item name="android:windowFullscreen">true</item>
    <item name="android:windowContentOverlay">@null</item>
    <item name="android:navigationBarColor">@android:color/transparent</item>
    <item name="android:statusBarColor">@android:color/transparent</item>
    <item name="android:enforceStatusBarContrast" tools:targetApi="q">false</item>
    <item name="android:enforceNavigationBarContrast"  tools:targetApi="q">false</item>

    <!-- 新增属性 -->
    <!-- 允许窗口绘制系统栏背景，保证透明设置生效 -->
    <item name="android:windowDrawsSystemBarBackgrounds">true</item>
    <!-- Android 12+ 关闭状态栏图标浅色模式，避免触发系统自动添加深色背景 -->
    <item name="android:windowLightStatusBar" tools:targetApi="s">false</item>
    <!-- 禁用状态栏半透明遮罩 -->
    <item name="android:windowTranslucentStatus" tools:targetApi="kitkat">true</item>
</style>

二、优化Activity代码逻辑 #

在onCreate方法中补充Android 12+专属的系统栏控制逻辑，添加窗口布局无限制标记：

super.onCreate(savedInstanceState)
// 让内容延伸到系统栏区域，必须在setContentView之前调用
WindowCompat.setDecorFitsSystemWindows(window, false)

// 强制窗口内容覆盖系统栏区域
window.setFlags(
    WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS,
    WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS
)

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    val windowInsetsController = WindowCompat.getInsetsController(window, window.decorView)
    windowInsetsController.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
    windowInsetsController.hide(WindowInsetsCompat.Type.systemBars())
    // 清除状态栏浅色外观标记，确保背景完全透明
    windowInsetsController.setSystemBarsAppearance(
        0,
        WindowInsetsControllerCompat.APPEARANCE_LIGHT_STATUS_BARS
    )
} else {
    @Suppress("DEPRECATION")
    window.decorView.systemUiVisibility = (View.SYSTEM_UI_FLAG_IMMERSIVE
            or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
            or View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
            or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
            or View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
            or View.SYSTEM_UI_FLAG_FULLSCREEN)
}

// 后续调用setContentView
setContentView(R.layout.your_webview_layout)

三、WebView布局适配 #

确保WebView及其父布局都设置fitsSystemWindows="false"，避免WebView自动预留系统栏空间导致状态栏区域被额外渲染：

<!-- WebView所在布局文件 -->
<LinearLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="false">

    <WebView
        android:id="@+id/webview"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:fitsSystemWindows="false"/>
</LinearLayout>

四、额外注意事项 #

• 若Web页面使用了<meta name="viewport" content="viewport-fit=cover">，请保留该设置，确保Web内容完全覆盖屏幕（含系统栏区域）。
• 测试时关闭设备"深色模式"，避免全局主题干扰状态栏显示。

内容的提问来源于stack exchange，提问作者Claude Hangui