Android Activity边缘到边缘主题：消除Fragment切换状态栏遮罩闪烁

AI 小北

2026-7-8

问题分析

你当前的配置仅在API29+设置了状态栏透明，但缺少全局边缘到边缘的主题配置和启动阶段的状态栏颜色控制，导致Fragment切换过渡时Activity的默认状态栏底色（蓝色）露出，启动时也会短暂闪蓝。同时未配合代码启用边缘到边缘布局，使得Fragment内容未完全覆盖状态栏区域。

解决方案

1. 统一全局主题配置（覆盖所有API级别）

修改values/themes.xml，将边缘到边缘的配置整合到基础主题中，无需单独在v29目录设置：

<!-- values/themes.xml -->
<style name="Base.Theme.App" parent="Theme.Material3.DayNight.NoActionBar">
    <!-- 设置状态栏、导航栏为透明 -->
    <item name="android:statusBarColor">@android:color/transparent</item>
    <item name="android:navigationBarColor">@android:color/transparent</item>
    
    <!-- 允许内容延伸到刘海/系统栏区域 -->
    <item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
    
    <!-- Material3 官方边缘到边缘启用标记 -->
    <item name="edgeToEdgeEnabled">true</item>
    
    <!-- 可选：如果是亮色主题，设置状态栏文字为深色（暗色主题可移除） -->
    <item name="android:windowLightStatusBar">true</item>
</style>

<style name="Theme.App" parent="Base.Theme.App">
    <!-- 更高版本的额外配置（如需要） -->
</style>

删除v29/themes.xml中重复的android:statusBarColor配置，保持主题统一。

2. 解决启动时的闪蓝问题

设置启动专属主题，确保应用启动瞬间状态栏就是透明的：
在values/themes.xml中添加闪屏主题：

<style name="Theme.App.Splash" parent="Theme.Material3.DayNight.NoActionBar">
    <item name="android:statusBarColor">@android:color/transparent</item>
    <!-- 替换为你的闪屏背景图/颜色 -->
    <item name="android:windowBackground">@color/surface</item>
    <item name="android:windowLightStatusBar">true</item>
</style>

修改Manifest中MainActivity的启动主题：

<activity
    android:name=".ui.uielements.activities.MainActivity"
    android:exported="true"
    android:theme="@style/Theme.App.Splash"> <!-- 启动时使用闪屏主题 -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

在MainActivity的onCreate中切换回主主题：

override fun onCreate(savedInstanceState: Bundle?) {
    // 必须在super.onCreate之前切换主题
    setTheme(R.style.Theme.App)
    super.onCreate(savedInstanceState)
    
    // 启用系统栏适配，让内容延伸到状态栏下方
    WindowCompat.setDecorFitsSystemWindows(window, false)
    
    setContentView(R.layout.activity_main)
    // 其他初始化代码...
}

3. 确保Fragment适配边缘到边缘

在每个Fragment的onViewCreated中处理系统栏内边距，让Fragment内容覆盖状态栏区域：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    
    ViewCompat.setOnApplyWindowInsetsListener(view.rootView) { view, insets ->
        val systemBarsInsets = insets.getInsets(WindowInsetsCompat.Type.systemBars())
        // 给根布局设置内边距，避免内容被系统栏遮挡
        view.setPadding(
            systemBarsInsets.left,
            systemBarsInsets.top,
            systemBarsInsets.right,
            systemBarsInsets.bottom
        )
        insets
    }
}

验证效果

启动应用时不会再出现蓝色状态栏闪屏
Fragment切换（包括导航抽屉、FAB动画）时，Activity的状态栏底色不会露出
静态状态下边缘到边缘显示正常

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