升级到Android 15+ 以后如何适配Edge-To-Edge？

从 Android 15 开始，Google 强制启用 Edge-to-Edge（全屏/沉浸式）设计 ，应用的内容会扩展到屏幕四周，包括 状态栏 、导航栏 以及 通知栏 区域。

这意味着以前我们习惯的：

window.statusBarColor = Color.RED

在 Android 15 上将被废弃且不生效 ，状态栏颜色不再通过 statusBarColor 直接修改。

Android Studio 也会提示：

Draw proper background behind WindowInsets.Type.statusBars() instead.

即需要通过绘制状态栏区域的背景来实现颜色效果，而不是直接调用 statusBarColor。

---

2. 什么是 Edge-to-Edge？

Edge-to-Edge（全屏沉浸式设计）是一种让内容延伸到设备屏幕边缘的 UI 风格，视觉上更加沉浸、现代化。

之前 Android 允许我们用 fitsSystemWindows 来留出状态栏/导航栏区域，但 Android 15 起，Google 鼓励直接绘制到这些区域，由开发者自己管理间距与背景。

参考图示：

• 旧模式：状态栏和导航栏区域有固定背景色，内容下移
• 新模式：内容可以绘制到状态栏/导航栏区域，开发者自己决定留白和背景

---

3. statusBarColor 废弃后的替代方案

官方推荐

在 状态栏的 WindowInsets 区域 绘制你想要的背景。

核心思路是：

1. 获取状态栏的高度（通过 WindowInsets）。
2. 在该区域绘制一层背景色（View 或自定义布局）。
3. 内容区域根据需要加 padding 避开状态栏文字。

示例代码：

ViewCompat.setOnApplyWindowInsetsListener(rootView) { v, insets ->
    val statusBarInsets = insets.getInsets(WindowInsetsCompat.Type.statusBars())
    statusBarBackgroundView.layoutParams.height = statusBarInsets.top
    statusBarBackgroundView.setBackgroundColor(Color.RED)
    insets
}

statusBarBackgroundView 是你在布局里放在最上面的一个背景 View，用来替代 statusBarColor。

---

4. 临时解决方案（不推荐长期使用）

如果你的项目还没有时间完全适配 Edge-to-Edge，可以在 Manifest 里添加：

<application
    android:windowOptOutEdgeToEdgeEnforcement="true"
    ...>
</application>

或者只对单个 Activity 生效：

<activity
    android:name=".YourActivity"
    android:windowOptOutEdgeToEdgeEnforcement="true"
    ...>
</activity>

这样，window.statusBarColor 在 Android 15 上仍然会按老逻辑工作，方便快速兼容。

但注意：

• 该属性未来会被移除（官方已明确标记为即将弃用）。
• 只是为了给开发者一个过渡期，长期还是要改成 WindowInsets 绘制方式。

---

5. 迁移建议

时间阶段	做法
短期（快速上线）	使用 android:windowOptOutEdgeToEdgeEnforcement="true"保留旧行为
中期（逐步适配）	逐屏调整 UI，将状态栏/导航栏背景改为通过 View 绘制
长期（完全适配）	采用完整 Edge-to-Edge 设计，内容延伸到四周，背景和间距由开发者全权管理

---

6. 总结

• Android 15 起，statusBarColor 被废弃，不能直接修改状态栏颜色。
• 官方建议通过 WindowInsets 绘制背景 来控制状态栏样式。
• 可以用 windowOptOutEdgeToEdgeEnforcement 作为过渡方案，但要尽快迁移。
• Edge-to-Edge 是未来趋势，提前适配可以让 App 在新系统上视觉体验更好。