Android Studio中EdgeToEdge启用后切换全屏布局异常求助

你遇到的问题核心是EdgeToEdge模式和全屏模式的配置冲突，加上布局未正确适配Insets导致内容无法延伸到状态栏区域。以下是针对Android 15的有效解决方案：

1. 统一使用新的WindowInsets API（弃用旧SystemUiVisibility） #

Android 11+推荐用WindowInsetsController，避免新旧API混用。结合EdgeToEdge的设置，正确的全屏切换逻辑如下：

// 定义全局变量标记全屏状态
private boolean isFullscreen = false;

// 切换全屏的方法（比如绑定按钮点击事件）
private void toggleFullscreen() {
    Window window = getWindow();
    WindowInsetsController controller = window.getInsetsController();
    
    if (controller != null) {
        // 确保Decor不贴合系统窗口，允许布局延伸到状态栏/导航栏区域
        window.setDecorFitsSystemWindows(false);
        
        if (isFullscreen) {
            // 退出全屏：显示系统栏，恢复默认交互
            controller.show(WindowInsets.Type.statusBars() | WindowInsets.Type.navigationBars());
            controller.setSystemBarsBehavior(WindowInsetsController.BEHAVIOR_DEFAULT);
        } else {
            // 进入全屏：隐藏系统栏，设置滑动唤起
            controller.hide(WindowInsets.Type.statusBars() | WindowInsets.Type.navigationBars());
            controller.setSystemBarsBehavior(WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE);
        }
        isFullscreen = !isFullscreen;
    }
}

注意：EdgeToEdge.enable(this)内部已自动设置setDecorFitsSystemWindows(false)，无需重复调用，避免配置冲突。

2. 布局适配关键设置 #

• 根视图添加android:fitsSystemWindows="false"，允许布局铺满整个屏幕：

<LinearLayout
    android:id="@+id/root_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="false"
    android:orientation="vertical">
    
    <!-- 你的内容视图，比如全屏图片 -->
    <ImageView
        android:id="@+id/fullscreen_image"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:scaleType="centerCrop"
        android:adjustViewBounds="false" />
</LinearLayout>

• 图片展示场景必须设置scaleType="centerCrop"，保证图片填满容器且比例正常。

3. 动态处理Insets（可选） #

如果需要在全屏/非全屏切换时调整内容位置（避免非全屏时内容被状态栏遮挡），可监听Insets变化：

View rootView = findViewById(R.id.root_layout);
ViewCompat.setOnApplyWindowInsetsListener(rootView, (v, insets) -> {
    Insets systemInsets = insets.getInsets(WindowInsetsCompat.Type.systemBars());
    // 全屏时取消padding，非全屏时设置padding避开系统栏
    v.setPadding(
        isFullscreen ? 0 : systemInsets.left,
        isFullscreen ? 0 : systemInsets.top,
        isFullscreen ? 0 : systemInsets.right,
        isFullscreen ? 0 : systemInsets.bottom
    );
    return insets.consumeSystemWindowInsets();
});

4. 主题配置检查 #

确保Activity主题未设置固定状态栏颜色，避免切换全屏时出现黑色区域：

<style name="AppTheme.Fullscreen" parent="Theme.Material3.DayNight.NoActionBar">
    <item name="android:statusBarColor">@android:color/transparent</item>
    <item name="android:navigationBarColor">@android:color/transparent</item>
    <item name="android:windowTranslucentStatus">true</item>
    <item name="android:windowTranslucentNavigation">true</item>
</style>

按上述步骤修改后，切换全屏时布局会完全铺满屏幕（包含原状态栏区域），实现类似WhatsApp、Google Photos的全屏图片展示效果。

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