Android 15 中 ActionBar 重叠活动内容

问题描述

在 Android 15 中，当使用默认 ActionBar（通过主题 Theme.AppCompat.DayNight.DarkActionBar 定义）时，活动内容会被 ActionBar 重叠。该问题在 Android 14 及更早版本中不存在，表现为：

• 布局内容延伸至 ActionBar 区域
• 页面顶部元素被 ActionBar 遮挡
• 未在 XML 中声明自定义 Toolbar
• 即使已设置 android:windowContentOverlay 属性，问题依然存在

原因分析

Android 15 引入了新的 edge-to-edge 强制实施机制：

• 默认启用 edge-to-edge 模式（内容延伸至系统栏下方）
• 默认 ActionBar 作为应用内容绘制，而非系统控件
• 系统未为 ActionBar 自动预留布局空间
• 行为变化源于系统级渲染逻辑更新

解决方案

✅ 方案一：添加主题属性强制退出 edge-to-edge（推荐）

最优解决方案，仅需主题配置即可恢复早期版本行为：

1. 打开 res/values/themes.xml 文件
2. 在应用主题中添加以下属性：

<style name="AppBaseTheme" parent="Theme.AppCompat.DayNight.DarkActionBar">
    ...其他原有属性...
    <!-- 添加以下属性解决 Android 15 重叠问题 -->
    <item name="android:windowOptOutEdgeToEdgeEnforcement" tools:targetApi="vanillaIceCream">true</item>
</style>

3. 在 res/values-night/themes.xml 中进行相同修改确保夜间模式兼容

效果说明：

• windowOptOutEdgeToEdgeEnforcement 属性明确退出系统 edge-to-edge 强制
• 行为恢复至 Android 14 及更早版本样式
• tools:targetApi 确保仅 Android 15(VanillaIceCream) 及以上生效
• 无侵入性代码更改，纯声明式修复

---

🛠 方案二：完整主题属性组合（备选方案）

若方案一未能完全解决问题，可尝试组合属性：

<style name="AppBaseTheme" parent="Theme.AppCompat.DayNight.DarkActionBar">
    ...
    <!-- 三属性组合确保兼容性 -->
    <item name="android:windowDrawsSystemBarBackgrounds">true</item>
    <item name="android:fitsSystemWindows">true</item>
    <item name="android:windowOptOutEdgeToEdgeEnforcement" tools:targetApi="vanillaIceCream">true</item>
</style>

属性作用：

1. windowDrawsSystemBarBackgrounds：允许应用绘制系统栏背景
2. fitsSystemWindows：自动适配系统窗口插入
3. windowOptOutEdgeToEdgeEnforcement：退出新渲染机制

---

💻 方案三：编程式调整（自定义 view 适用）

适用场景：明确需要 edge-to-edge 效果且使用自定义 Toolbar/View

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 启用 edge-to-edge 显示
    EdgeToEdge.enable(this);
    setContentView(R.layout.activity_main);
    
    // 示例：为自定义 Toolbar 添加顶部安全区
    Toolbar toolbar = findViewById(R.id.rootToolbar);
    ViewCompat.setOnApplyWindowInsetsListener(toolbar, (v, windowInsets) -> {
        Insets insets = windowInsets.getInsets(WindowInsetsCompat.Type.systemBars());
        ViewGroup.MarginLayoutParams params = (ViewGroup.MarginLayoutParams) v.getLayoutParams();
        params.topMargin = insets.top; // 设置状态栏高度为上边距
        v.setLayoutParams(params);
        return windowInsets;
    });
}

核心 API：

• EdgeToEdge.enable(this)：显式启用 edge-to-edge
• getInsets(WindowInsetsCompat.Type.systemBars())：获取系统栏尺寸
• setOnApplyWindowInsetsListener：动态监听插入变化

使用限制

此方案要求：

1. 必须自定义 Toolbar 或根视图
2. 需确保布局中包含目标可操作元素
3. 适配复杂布局时需要额外处理嵌套监听

---

⚠ 常见误区与规避

1. 单独使用 fitsSystemWindows 的不足

   <!-- 单一使用可能造成背景异常或导航栏问题 -->
   <LinearLayout
       ...
       android:fitsSystemWindows="true">

   • 仅设置此属性会出现半透明背景穿透
   • 需配套设置系统栏背景（如方案二）

2. 移除 ActionBar 阴影的正确方式

   <!-- 正确移除 ActionBar 底部阴影 -->
   <item name="android:windowContentOverlay">@null</item>

   此操作仅影响视觉效果，不解决重叠问题

3. 版本检测注意事项 建议所有方案配套 tools:targetApi 属性：

   <!-- 确保仅目标版本生效 -->
   tools:targetApi="vanillaIceCream"

---

兼容性处理要点

方案类型	优点	短板	推荐指数
主题属性	零代码侵入 完美向下兼容	无法自定义视觉创新	⭐⭐⭐⭐⭐
编程式方案	支持全屏定制 精细控制布局	需手动处理各种屏幕类型 增大维护成本	⭐⭐

实践建议：98% 的情况下，方案一 windowOptOutEdgeToEdgeEnforcement 即可完全解决问题。仅在需要高级视觉效果时采用编程式方案。

最终推荐实现

<!-- res/values/themes.xml -->
<style name="AppBaseTheme" parent="Theme.AppCompat.DayNight.DarkActionBar">
    <item name="colorAccent">@color/secondary</item>
    <item name="android:actionBarStyle">@style/AppBaseTheme.ActionBarStyle</item>
    <item name="actionBarStyle">@style/AppBaseTheme.ActionBarStyle</item>
    <item name="android:textViewStyle">@style/RobotoTextViewStyle</item>
    <item name="android:buttonStyle">@style/RobotoButtonStyle</item>
    <item name="android:windowContentOverlay">@null</item>
    <!-- Android 15 兼容专属解决方案 -->
    <item name="android:windowOptOutEdgeToEdgeEnforcement" tools:targetApi="vanillaIceCream">true</item>
</style>

修改后无需重建项目，运行即可恢复 Android 14 标准布局行为。