Android设置状态栏渐变背景且不影响导航栏的方法

嘿，我完全懂你的需求——想要状态栏和下方布局的渐变效果完全融合，同时又不想让布局跑到导航栏里去，毕竟WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS这个属性确实会把整个布局都延伸到系统栏，太霸道了。别担心，不用这个Flag也能完美实现你的目标，下面给你几个亲测有效的方案：

方案一：系统透明状态栏 + 布局Insets适配 #

这是最通用的方案，适配绝大多数Android版本：

1. 配置主题 #

先在styles.xml里设置状态栏透明，同时锁定导航栏的颜色，防止布局侵入：

<style name="YourAppTheme" parent="Theme.MaterialComponents.Light.NoActionBar">
    <!-- 让状态栏完全透明 -->
    <item name="android:statusBarColor">@android:color/transparent</item>
    <!-- 自定义导航栏颜色，保持原有样式不被覆盖 -->
    <item name="android:navigationBarColor">@color/your_preferred_nav_color</item>
    <!-- Android 11+ 强制导航栏对比度，避免内容和导航栏混淆 -->
    <item name="android:enforceNavigationBarContrast">true</item>
</style>

2. 处理布局Insets #

核心思路是：让根布局的渐变背景延伸到状态栏，但内容区域要避开状态栏和导航栏，防止被遮挡。

如果你的布局结构是「根布局（渐变背景）+ 内容容器」，可以用ViewCompat.setOnApplyWindowInsetsListener来优雅适配：

// 根布局（设置了渐变背景的那个View）
val rootLayout = findViewById<ViewGroup>(R.id.root_layout)
// 内容容器（存放页面实际内容的View）
val contentContainer = findViewById<ViewGroup>(R.id.content_container)

ViewCompat.setOnApplyWindowInsetsListener(rootLayout) { view, insets ->
    // 获取状态栏和导航栏的Insets值
    val statusBarInsets = insets.getInsets(WindowInsetsCompat.Type.statusBars())
    val navBarInsets = insets.getInsets(WindowInsetsCompat.Type.navigationBars())

    // 给内容容器设置padding，避开状态栏和导航栏
    contentContainer.setPadding(
        contentContainer.paddingLeft,
        statusBarInsets.top,
        contentContainer.paddingRight,
        navBarInsets.bottom
    )

    // 让根布局只消耗导航栏的Insets，这样背景会自然延伸到状态栏
    insets.inset(0, 0, 0, navBarInsets.bottom)
}

如果是使用AppBarLayout，更简单：直接给AppBarLayout设置android:fitsSystemWindows="true"，它的渐变背景会自动延伸到状态栏，同时系统会自动处理内容的适配，不用额外写代码。

方案二：Android 11+ 专用的WindowInsetsController #

如果你只需要适配Android 11及以上版本，可以用更简洁的API：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    window.insetsController?.run {
        // 设置状态栏图标为浅色（如果你的渐变背景是深色，就去掉这行）
        setSystemBarsAppearance(
            WindowInsetsController.APPEARANCE_LIGHT_STATUS_BARS,
            WindowInsetsController.APPEARANCE_LIGHT_STATUS_BARS
        )
        // 状态栏透明
        window.statusBarColor = Color.TRANSPARENT
        // 导航栏保持自定义颜色
        window.navigationBarColor = resources.getColor(R.color.your_preferred_nav_color, theme)
    }
}

这个方案不需要处理布局Insets，系统会自动让背景延伸到状态栏，同时导航栏不受影响。

关键注意点 #

• 确保你的根布局（或AppBarLayout）设置了渐变背景，这样状态栏透明后才能显示出渐变效果。
• 绝对不要用FLAG_LAYOUT_NO_LIMITS，这个Flag会让布局同时覆盖状态栏和导航栏，正是你要避免的情况。
• 如果需要状态栏图标颜色适配（比如浅色背景用深色图标），可以通过ViewCompat.getWindowInsetsController(window.decorView)?.isAppearanceLightStatusBars = true来切换。

这样设置后，状态栏就会完全“隐形”，只显示系统图标，背景和下方布局的渐变完全一致，导航栏也会保持正常的样式，完美符合你的需求~

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