Android WMS(一)—— 窗口和窗口容器树

439 阅读6分钟

窗口容器树系列文章:

  1. Android WMS(一)—— 窗口和窗口容器树
  2. Android WMS(二)—— 窗口容器树的构建

1. 什么是窗口?

窗口是 Android 显示体系中的核心抽象,用于表示一个独立的可显示区域,负责承载应用界面内容,并连接应用 UI、系统窗口管理与底层渲染机制,是界面从应用逻辑到屏幕呈现的关键桥梁。

常见窗口包括:

  • Activity 主窗口
  • Dialog
  • PopupWindow
  • 状态栏
  • 导航栏
  • 输入法窗口
  • 壁纸窗口

2. Z-order

窗口之所以会互相遮挡,本质上是因为它们有前后顺序,也就是常说的 Z-Order。Z-Order 指窗口在Z轴的排序,离用户越近,Z值越大。

当进程向 WMS 申请窗口时,WMS 会根据窗口类型和系统规则,为其分配对应的显示层级,从而决定窗口的前后遮挡关系。

那么,如何控制窗口的层级?应用开发者只能通过 WindowType 指定窗口类型,不能直接控制 Z-order。

系统会通过 Type → Layer 映射机制,最终将 WindowType 映射为 Z-order。

2.1 WindowType

App 和 WMS 之间需要定义一些规则协议,这些协议就是 Window 的属性,定义在 WindowManager 的内部类 LayoutParams 中。其中:

Window Type 用于描述窗口的类型,将其划分为三类:

  • 应用窗口(Application Window,1~99)
  • 子窗口(Sub Window,1000~1999)
  • 系统窗口(System Window,2000~2999)

错误理解:type 越大层级越高

正确理解:选择正确的 type,WMS 自动分配层级

2.2 WindowLayer

WindowManagerPolicy 类中定义窗口策略层级,共 37 (0-36)个层级槽位,每个 Layer 对应一个槽位:

2.3 Type → Layer 映射机制

系统通过 getWindowLayerFromTypeLw() 将不同的 Window Type 映射到这 37 个 Policy Layer 中的某一层,再基于该层级计算窗口的最终显示顺序。

// WindowManagerPolicy.java - 窗口类型到层级的映射
default int getWindowLayerFromTypeLw(int type, boolean canAddInternalSystemWindow,
        boolean roundedCornerOverlay) {
    // 圆角覆盖层始终在最顶层
    if (roundedCornerOverlay && canAddInternalSystemWindow) {
        return getMaxWindowLayer();  // 36
    }
    // 所有应用窗口共享同一个层级
    if (type >= FIRST_APPLICATION_WINDOW && type <= LAST_APPLICATION_WINDOW) {
        return APPLICATION_LAYER;  // 2
    }
    // 每种系统窗口类型对应一个固定层级
    switch (type) {
        case TYPE_WALLPAPER:               return  1;  // 壁纸
        case TYPE_PHONE:                   return  3;  // 电话
        case TYPE_TOAST:                   return  7;  // Toast
        case TYPE_APPLICATION_OVERLAY:     return 11;  // 应用覆盖层
        case TYPE_INPUT_METHOD:            return 13;  // 输入法
        case TYPE_STATUS_BAR:              return 15;  // 状态栏
        case TYPE_NAVIGATION_BAR:          return 24;  // 导航栏
        case TYPE_SYSTEM_ERROR:            return 27;  // 系统错误
        case TYPE_ACCESSIBILITY_OVERLAY:   return 31;  // 无障碍覆盖层
        case TYPE_POINTER:                 return 35;  // 鼠标指针
        // ...
    }
}
image.png

Window Type → Window Layer → Z-order → 最终显示顺序

3. WindowContainer 窗口管理树

3.1 窗口管理树

作为 WMS 内部最核心的逻辑数据结构,WindowContainer 树(下文统称为“窗口管理树”)构建了整个 Android 显示系统中所有窗口组件的层级拓扑。

WindowContainer 管理树管的是“窗口对象之间的管理关系”,比如:

  • 谁是谁的父节点
  • 谁在谁上面
  • 配置怎么往下传
  • 可见性怎么往下传播
  • 动画和转场作用在哪一整组节点上

WindowContainer 管理树上的节点大多是 WindowContainer 及其子类,例如:

  • RootWindowContainer
  • DisplayContent
  • DisplayArea
  • TaskDisplayArea
  • Task
  • TaskFragment
  • ActivityRecord
  • WindowToken
  • WindowState

3.2 简化总图

在讲每一个类之前,先从全局看一遍 Android 14 中最常见的单屏 WindowContainer 管理树结构。

RootWindowContainer
`-- DisplayContent
    `-- RootDisplayArea (ANY)
        |-- DisplayArea (BELOW_TASKS)
        |   `-- DisplayArea.Tokens
        |       `-- WindowToken
        |           `-- WindowState
        |
        |-- TaskDisplayArea 
        |   `-- Task (RootTask)
        |       `-- Task / TaskFragment
        |           `-- ActivityRecord
        |               |-- WindowState (TYPE_BASE_APPLICATION)
        |               |-- WindowState (TYPE_APPLICATION_STARTING)
        |               `-- WindowState (Dialog / Panel / attached window)
        |
        `-- DisplayArea (ABOVE_TASKS)
            |-- DisplayArea.Tokens
            |   `-- WindowToken
            |       `-- WindowState
            `-- ImeContainer / IME 对应区域
                `-- WindowToken
                    `-- WindowState
  1. 整个设备最上层是 RootWindowContainer
  2. 每一块实际屏幕在这棵管理树里对应一个 DisplayContent
  3. 到了 DisplayContent 内部以后,这棵管理树会分成两大主路径:
    • 应用窗口路径:TaskDisplayArea -> Task -> TaskFragment -> ActivityRecord -> WindowState
    • 非应用窗口路径:DisplayArea.Tokens -> WindowToken -> WindowState

4. 主要节点详解

4.1 WindowContainer

class WindowContainer<E extends WindowContainer> extends ConfigurationContainer<E>
        implements Comparable<WindowContainer>, Animatable, SurfaceFreezer.Freezable,
        InsetsControlTarget {
    private WindowContainer<WindowContainer> mParent = null;
    protected final WindowList<E> mChildren = new WindowList<E>();
}

窗口树节点的统一抽象基类是 WindowContainer<E>,定义容器的通用功能。所有节点都共享它的 4 个核心能力:

  1. 用 mParent / mChildren 维护父子关系
  2. 用 mChildren 维护兄弟节点顺序
  3. 向下传播配置、可见性和动画状态
  4. 作为逻辑容器去绑定 SurfaceControl

其中最关键的是 mChildren。源码注释写得很明确:

// List is in z-order as the children appear on
// screen with the top-most window container at the tail of the list.

也就是说,mChildren 本身就是按 Z-Order 排好的,列表尾部的子节点在视觉上最靠前。WindowContainer 维护层级顺序,主要靠 addChild(...) 和 positionChildAt(...) 这类方法完成。

4.2 RootWindowContainer

class RootWindowContainer extends WindowContainer<DisplayContent>
        implements DisplayManager.DisplayListener {
}

一个 Android 系统(一个 SystemServer / WindowManagerService)中只存在一个 RootWindowContainer,它作为全局窗口树的根,统一管理所有 DisplayContent。

所以它负责的是设备级问题:

  • 管理所有 DisplayContent
  • 维护焦点屏幕、睡眠状态、旋转等全局状态
  • 作为 ATMS 和 WMS 协调显示行为的顶层入口

4.3 DisplayContent

class DisplayContent extends RootDisplayArea implements WindowManagerPolicy.DisplayContentInfo {
}

DisplayContent 的数量由 DisplayManagerService 中存在的 Display 决定,注意 Display 的数量不等同于物理屏幕数量。

4.4 RootDisplayArea 和 DisplayArea

public class DisplayArea<T extends WindowContainer> extends WindowContainer<T> {
}

RootDisplayArea 是 WMS 在 DisplayContent 下建立的“显示区域树根节点”。它本身不承载应用窗口,而是作为 DisplayArea 树的根,统一管理 TaskDisplayArea(应用任务区域)、DisplayArea.Tokens(系统窗口区域)等子区域,从而把“窗口类型”和“窗口所在区域”解耦

DisplayContent 表示一块完整屏幕;DisplayArea 表示这块屏幕中的一个层级分区。DisplayContent 负责管理整个 Display,而 DisplayArea 负责管理某一类窗口的 Z-Order 和组织结构。

4.5 TaskDisplayArea -> Task / TaskFragment -> ActivityRecord

应用窗口路径:

TaskDisplayArea
`-- Task
    `-- TaskFragment
        `-- ActivityRecord
            `-- WindowState

这条路径里每一层负责的事情分别是:

1. TaskDisplayArea:代表了屏幕上一块专门用来存放 App 窗口的区域。它的子容器通常是 Task。

2. Task:Android 系统中任务栈的具体实现,继承自 TaskFragment,用于管理一组相关的 Activity。

3. TaskFragment:TaskFragment 是 Task 内部的子容器,用来进一步细分 Activity 组织结构。TaskFragment 是 Task 内部用于多窗口/分屏场景的子容器,用来进一步组织 Activity。

4. ActivityRecord:ActivityRecord 对象用于描述 App 端的一个 Activity 对象(Activity 窗口)。ActivityRecord 继承自 WindowToken, ActivityRecord 是 WindowState 的容器。

应用窗口的主窗口、启动窗口、Dialog、Panel、attached window,都会挂到这个 ActivityRecord 下面。 可以压缩成下面这样:


4.6 DisplayArea.Tokens -> WindowToken -> WindowState

非应用窗口路径:

DisplayArea.Tokens
`-- WindowToken
    `-- WindowState

1. WindowToken: 是窗口分组容器,用于管理一组相关窗口,负责窗口归属、层级以及生命周期管理。应用窗口中,ActivityRecord 继承了 WindowToken 的能力,因此结构为:

2. WindowState: 是 WMS 中实际代表窗口的对象,保存窗口属性、层级信息以及对应的 SurfaceControl。它通常是窗口树的末端节点,也是连接 WMS、SurfaceFlinger 和输入系统的核心对象。

4.7 窗口节点图

image.png