窗口容器树系列文章:
- Android WMS(一)—— 窗口和窗口容器树
- 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; // 鼠标指针
// ...
}
}
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
- 整个设备最上层是 RootWindowContainer
- 每一块实际屏幕在这棵管理树里对应一个 DisplayContent
- 到了 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 个核心能力:
- 用 mParent / mChildren 维护父子关系
- 用 mChildren 维护兄弟节点顺序
- 向下传播配置、可见性和动画状态
- 作为逻辑容器去绑定 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 和输入系统的核心对象。