Android 15+ 保留状态栏空间

问题描述

Android 15引入的enableEdgeToEdge()功能允许应用充分利用屏幕边缘到边缘的空间，但这会导致应用内容直接延伸到状态栏下方，造成文字或界面元素与状态栏信息重叠。开发者需要一种方案，既保持现代的全屏视觉效果，又能保留状态栏所需空间，确保内容不会被遮挡。

推荐解决方案

📌 方案1：使用 WindowInsets API (首选方案)

这是官方推荐的方法，支持动态调整且适配不同设备。在应用主题样式中启用全屏后，通过监听窗口插入区域（WindowInsets）来设置相应间距：

// 在 Activity 的 onCreate() 中启用全屏模式
enableEdgeToEdge()

// 设置 WindowInsets 监听器
ViewCompat.setOnApplyWindowInsetsListener(binding.mainContainer) { view, insets ->
    val systemBars = insets.getInsets(
        WindowInsetsCompat.Type.systemBars() or 
        WindowInsetsCompat.Type.displayCutout()
    )
    
    // 更新主视图的边距
    view.updatePadding(
        top = systemBars.top,
        bottom = systemBars.bottom
    )
    
    // 消耗插入事件，阻止进一步传递
    WindowInsetsCompat.CONSUMED
}

原理说明

1. enableEdgeToEdge() 启用全屏布局
2. ViewCompat.setOnApplyWindowInsetsListener 监听系统栏位置变化
3. getInsets() 获取系统栏的精确尺寸
4. updatePadding() 动态调整视图内边距
5. CONSUMED 标志事件被消耗，防止重复处理

此方案在多种设备上运行效果：

• ✅ 普通屏幕
• ✅ 刘海屏/挖孔屏
• ✅ 折叠屏

🔧 方案2：主题属性配置 (快速修复)

通过修改应用主题强制保留系统栏空间：

<!-- res/values/themes.xml -->
<style name="AppTheme" parent="Theme.Material3.DayNight">
    <!-- 禁用全屏强制布局 -->
    <item name="windowOptOutEdgeToEdgeEnforcement">true</item>
    
    <!-- 替代兼容方案 -->
    <item name="android:windowTranslucentStatus">true</item>
    <item name="android:fitsSystemWindows">true</item>
</style>

各属性作用说明（点击展开）

• windowOptOutEdgeToEdgeEnforcement: 临时禁用 Android 15 的全屏强制行为（过渡方案）
• windowTranslucentStatus: 透明状态栏(Android 4.4+)
• fitsSystemWindows: 自动添加系统栏占位空间

方案2注意事项

此方法只作为过渡兼容方案，官方已明确表示windowTranslucentStatus在后续版本可能被废弃。如需长期兼容，建议采用方案1

🌈 方案3：状态栏占位视图

结合装饰视图与空间占位技术，创建视觉自定义性更强的方案：

<!-- 布局文件中添加占位视图 -->
<View
    android:id="@+id/statusPlaceholder"
    android:layout_width="match_parent"
    android:layout_height="0dp"
    android:background="@color/status_bar_background" />

// 在 Activity 中动态调整高度
ViewCompat.setOnApplyWindowInsetsListener(binding.root) { _, insets ->
    val statusBarHeight = insets.getInsets(
        WindowInsetsCompat.Type.statusBars()
    ).top
    
    binding.statusPlaceholder.apply {
        layoutParams.height = statusBarHeight
        visibility = View.VISIBLE
    }
    
    WindowInsetsCompat.CONSUMED
}

此方案优点：

• 完全控制状态栏区域背景色
• 可独立添加渐变/动态颜色效果
• 与其他解决方案无属性冲突

方案对比与选用建议

方案	优点	缺点	适用场景
WindowInsets API	官方推荐、未来兼容性好	需在代码中实现	新建应用/深度定制
主题属性配置	快速生效、零代码修改	老版本API可能被弃用	紧急修复/短期方案
占位视图	视觉定制灵活	添加额外DOM元素	特殊设计效果需求

最佳实践

1. 优先采用方案1：遵循Android官方边缘到边缘设计规范
2. 测试多版本兼容：Android 10+需使用稳定位获取方法
3. 避免重复调整：通过CONSUMED标志防止多余布局计算
4. 状态栏颜色协调：使用Window.setStatusBarColor()同步颜色风格

// 设置状态栏颜色协调的示例
WindowCompat.setDecorFitsSystemWindows(window, false)
window.statusBarColor = Color.TRANSPARENT

常见问题解决

Q: 为什么添加监听器后多次触发布局？
A: 确保返回WindowInsetsCompat.CONSUMED，否则窗口插入事件会继续传播

Q: 部分手机顶部仍有遮挡？
A: 加入WindowInsetsCompat.Type.displayCutout()处理异形屏的孔洞区域

Q: 兼容Android 10以下版本？
A: 使用WindowInsetsCompat代替原始API解决兼容性问题

val topInset = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    insets.getInsets(WindowInsets.Type.statusBars()).top
} else {
    @Suppress("DEPRECATION")
    insets.systemWindowInsetTop
}

通过以上方案，可在保留全屏效果的同时，确保内容与系统UI完美共存，提供无缝的用户体验。官方WindowInsets方案作为未来适配的基础，可有效适应后续Android版本升级带来的UI变化。