从一个Bug深入WindowInsets 的传递机制演化

柿蒂
477 阅读4分钟

前言：

Android低版本中的 WindowInsets 分发机制是「懒惰式且缺乏自动性」的 —— 依赖 ViewRootImpl.performTraversals() 调用链的主动触发，无法在布局未完成的场景中保证完整、时机正确地分发 Insets。

从一个Bug开始说起：

今天测试反馈了一个bug，有个项目的某个界面，有一个按钮，应该正常显示的，那个界面的情况是【刚进入时是沉浸式图片的状态，点击后隐藏所有图标进入全屏状态，再次点击显示图片恢复沉浸式图片的状态】，但是在某些设备上无法显示，排查后发现，出现这个问题的前提是：

  • Android10以下的部分设备，特别是8.0、8.1的设备
  • 从全屏状态恢复沉浸式图片状态后按钮的隐藏和显示正常

图片

看起来很奇怪，但是想起前几天解决的【底部导航栏开启导致toolbar的显示问题】的问题，感觉很可能是系统的问题，有兴趣的可以去看一下这篇文章：

全屏状态下出现的布局异常

陈洋洋，公众号：柿蒂为什么开启底部导航栏（三大金刚键）后，全屏或沉浸式模式会出现布局异常

先看一下沉浸式图片的代码：

fun enterImageImmersiveMode(activity: AppCompatActivity, lightStatusBar: Boolean = false) {
        val window = activity.window
        val controller = WindowInsetsControllerCompat(window, window.decorView)

        // 使用post延迟执行以确保UI状态稳定
        window.decorView.post {
            WindowCompat.setDecorFitsSystemWindows(window, false)
            window.statusBarColor = Color.TRANSPARENT
            window.navigationBarColor = Color.TRANSPARENT

            controller.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_DEFAULT
            controller.show(WindowInsetsCompat.Type.systemBars())
            controller.isAppearanceLightStatusBars = lightStatusBar
            controller.isAppearanceLightNavigationBars = lightStatusBar

            activity.supportActionBar?.hide() 
        }
    }

为了避免设置的问题特意加上了post，但是还是有问题，而调用下面的代码后，设置isVisible就正常了

  fun enterFullscreen(activity: AppCompatActivity) {
        val window = activity.window
        WindowCompat.setDecorFitsSystemWindows(window, false)

        val controller = WindowInsetsControllerCompat(window, window.decorView)
        controller.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE

        // 使用post延迟执行以确保UI状态稳定
        window.decorView.post {
            controller.hide(WindowInsetsCompat.Type.systemBars())
            activity.supportActionBar?.hide()
        }
    }

问题本质分析

这是 WindowInsets 与 View 布局生命周期在 Android 8 下处理不一致 导致的，具体包括：

  • WindowCompat.setDecorFitsSystemWindows(window, false) 会关闭系统为内容添加 padding 的行为；

  • Android 8 系统对 WindowInsets 传递不如 Android 10+ 灵活——如果 decorView 尚未完成 layout，系统栏的 insets 会导致布局异常；

  • 我的预设，使用用 post {} 包裹设置逻辑是对的，但在 Android 8 上仍然可能出现 View 不重新 layout 或 requestLayout 无效的情况；

  • 设置 isVisible = true 其实底层调用了 View.setVisibility(View.VISIBLE)，但这个 View 如果 layout 未完成或区域为 0x0，它不会显示；

  • 而在后续调用 controller.hide(WindowInsetsCompat.Type.systemBars()) 的时候，触发了一次系统栏动画，从而间接触发了一次 layout 调整 → View 才重新显示出来。

深入剖析：WindowInsets 的传递机制演化

Android版本WindowInsets分发机制是否自动触发重新分发是否支持动态监听Insets变化
Android 4.4 (API 19)初步引入，使用 fitSystemWindows()❌ 手动触发❌
Android 5~8 (API 21–27)WindowInsets 支持透明状态栏，但依赖 ViewRootImpl 分发❌（需要手动调用 requestApplyInsets()）❌
Android 9 (API 28)小幅增强，支持异形屏，但仍需手动触发❌✅ 部分事件
Android 10+ (API 29+)系统主动监听 WindowInsets 变化，并自动分发✅ 自动触发✅ 完整支持

所以，在 Android 8 及以前：

  • WindowInsets 分发不是自动的；

  • 只有在 layout 流程中调用 dispatchApplyWindowInsets() 才有效；

  • 一旦 View 是 GONE 或尺寸为 0，在 performTraversals() 过程中它不会参与 insets 分发；

  • 导致后续将 View 设置为 VISIBLE 时，它不会自动收到 Insets，即使它应该需要。

深入剖析：为什么 Android 10+ 就不会出这个问题？

从 Android 10（API 29） 开始，谷歌对 WindowInsets 做了核心重构：

改进说明
View.OnApplyWindowInsetsListener 增强改为「监听 + 主动分发」机制
ViewRootImpl 改动引入 WindowInsetsAnimationController 和 InsetsState，用于实时动画支持
DecorView 支持透明栏动画在 insets 改变时自动 request layout 和重新分发
WindowInsetsController 提供完整动画行为可以通过滑动触发系统栏显示/隐藏，保证时序正确

所以 Android 10+ 可以保证即使在 View 动态变为 VISIBLE 后，也能重新触发 Insets 传递流程，而 Android 8 不会。

深入剖析：Android 8 源码中的关键限制

我们可以从 Android 8 中的 ViewRootImpl.performTraversals()  看到如下逻辑：

if (mFirst || windowShouldResize || insetsChanged || ...) {
    performMeasure();
    performLayout();
    performDraw();
}

其中 insetsChanged 只有在窗口尺寸或类型变化时才会触发，且：

dispatchApplyInsets(windowInsets);

只有在 layout 流程中执行，如果 View 在这个阶段是 GONE 或不可见，系统不会再重新分发一次 insets，需要手动：

view.requestApplyInsets()  // 或 decorView

倒推bug出现的情况

场景：

  • 在进入沉浸模式后立即设置 View.isVisible = true

  • 这个 View 原本是 GONE，并且尚未 measure/layout

  • Android 8 中不会主动重新调用 dispatchApplyWindowInsets()，导致这个 View 没有 paddingTop（状态栏 inset）

结果：

  • 该 View 的 layout 或 draw 阶段位置错误（比如被导航栏挡住），或者尺寸为 0

  • 会发现 “设置了 VISIBLE，但没显示出来”

解决方案：

初始化沉浸式图片展示状态时手动调用【window.decorView.requestApplyInsets() 】，强制刷新 Insets 和 Layout

fun enterImageImmersiveMode(activity: AppCompatActivity, lightStatusBar: Boolean = false) {
        val window = activity.window
        val controller = WindowInsetsControllerCompat(window, window.decorView)

        // 使用post延迟执行以确保UI状态稳定
        window.decorView.post {
            WindowCompat.setDecorFitsSystemWindows(window, false)
            window.statusBarColor = Color.TRANSPARENT
            window.navigationBarColor = Color.TRANSPARENT

            controller.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_DEFAULT
            controller.show(WindowInsetsCompat.Type.systemBars())
            controller.isAppearanceLightStatusBars = lightStatusBar
            controller.isAppearanceLightNavigationBars = lightStatusBar

            activity.supportActionBar?.hide()
            // 强制刷新 Insets 和 Layout
            window.decorView.requestApplyInsets()   
        }
    }

原文地址：mp.weixin.qq.com/s/3zL45pcQz…

avatar
文章
阅读
粉丝