Android 13 WMS源码解析：手把手教你读懂DisplayArea层级树的构建过程-洪萨配资

Android 13 WMS深度解析：从源码到实践的DisplayArea层级树构建指南

在Android窗口管理系统的演进历程中，DisplayArea的引入彻底改变了窗口层级的管理方式。作为WindowManagerService（WMS）的核心组件，DisplayArea层级树决定了每个窗口的显示优先级和视觉层次。本文将带您深入Android 13源码，通过实战演示如何构建完整的DisplayArea层级结构。

1. DisplayArea架构基础与核心概念

DisplayArea是现代Android窗口管理系统的基石，它取代了早期版本中简单的WindowStack机制。理解其工作原理需要掌握几个关键概念：

窗口层级（Window Layer）：Android系统将窗口划分为36个层级（0-35），每个层级对应特定类型的窗口。例如：

层级1：壁纸窗口（TYPE_WALLPAPER）
层级24：导航栏（TYPE_NAVIGATION_BAR）
层级13：输入法窗口（TYPE_INPUT_METHOD）

Feature与DisplayArea的对应关系：

class Feature { String mName; // 如"WindowedMagnification" int mId; // 如FEATURE_WINDOWED_MAGNIFICATION boolean[] mWindowLayers; // 36个布尔值，表示影响哪些层级 }

层级树构建的关键类：

DisplayAreaPolicyBuilder：策略构建器
HierarchyBuilder：层级构建器
PendingArea：构建过程中的临时节点

通过dumpsys命令可以查看实时的DisplayArea层级结构：

adb shell dumpsys window displays

2. 构建流程的源码解析

2.1 初始化入口：DisplayContent的创建

DisplayArea树的构建始于DisplayContent的初始化过程：

// frameworks/base/services/core/java/com/android/server/wm/DisplayContent.java DisplayContent(Display display, RootWindowContainer root) { super(root.mWindowManager, "DisplayContent", FEATURE_ROOT); configureSurfaces(pendingTransaction); } private void configureSurfaces(Transaction transaction) { if (mDisplayAreaPolicy == null) { mDisplayAreaPolicy = mWmService.getDisplayAreaPolicyProvider() .instantiate(mWmService, this, this, mImeWindowsContainer); } }

DefaultProvider的instantiate方法完成了关键准备工作：

// frameworks/base/services/core/java/com/android/server/wm/DisplayAreaPolicy.java public DisplayAreaPolicy instantiate(WindowManagerService wmService, DisplayContent content, RootDisplayArea root, DisplayArea.Tokens imeContainer) { final TaskDisplayArea defaultTaskDisplayArea = new TaskDisplayArea(...); final List<TaskDisplayArea> tdaList = new ArrayList<>(); tdaList.add(defaultTaskDisplayArea); final HierarchyBuilder rootHierarchy = new HierarchyBuilder(root); rootHierarchy.setImeContainer(imeContainer).setTaskDisplayAreas(tdaList); if (content.isTrusted()) { configureTrustedHierarchyBuilder(rootHierarchy, wmService, content); } return new DisplayAreaPolicyBuilder() .setRootHierarchy(rootHierarchy) .build(wmService); }

2.2 Feature配置详解

configureTrustedHierarchyBuilder方法定义了主屏幕特有的Feature：

private void configureTrustedHierarchyBuilder(HierarchyBuilder rootHierarchy, WindowManagerService wmService, DisplayContent content) { // 窗口放大功能（最顶层） rootHierarchy.addFeature(new Feature.Builder(...) .upTo(TYPE_ACCESSIBILITY_MAGNIFICATION_OVERLAY) .except(TYPE_ACCESSIBILITY_MAGNIFICATION_OVERLAY) .setNewDisplayAreaSupplier(DisplayArea.Dimmable::new) .build()); if (content.isDefaultDisplay) { // 隐藏刘海区域 rootHierarchy.addFeature(new Feature.Builder(...) .all() .except(TYPE_NAVIGATION_BAR, TYPE_NAVIGATION_BAR_PANEL, ...) .build()); // 单手模式 rootHierarchy.addFeature(new Feature.Builder(...) .all() .except(TYPE_NAVIGATION_BAR, TYPE_NAVIGATION_BAR_PANEL, ...) .build()); } // 全屏放大 rootHierarchy.addFeature(...); // 输入法占位 rootHierarchy.addFeature(...); }

每个Feature通过以下方法定义其影响范围：

upTo()：指定影响的最大层级
all()：影响所有层级
except()：排除特定类型窗口
and()：仅包含特定类型窗口

2.3 层级树的构建算法

DisplayAreaPolicyBuilder.build()是构建过程的核心：

Result build(WindowManagerService wmService) { validate(); mRootHierarchyBuilder.build(mDisplayAreaGroupHierarchyBuilders); return new Result(...); }

构建过程分为两个关键阶段：

阶段一：Feature树构建

PendingArea[] areaForLayer = new PendingArea[maxWindowLayerCount]; final PendingArea root = new PendingArea(null, 0, null); Arrays.fill(areaForLayer, root); for (int i = 0; i < mFeatures.size(); i++) { final Feature feature = mFeatures.get(i); PendingArea featureArea = null; for (int layer = 0; layer < maxWindowLayerCount; layer++) { if (feature.mWindowLayers[layer]) { if (featureArea == null || featureArea.mParent != areaForLayer[layer]) { featureArea = new PendingArea(feature, layer, areaForLayer[layer]); areaForLayer[layer].mChildren.add(featureArea); } areaForLayer[layer] = featureArea; } else { featureArea = null; } } }

阶段二：叶子节点补充

PendingArea leafArea = null; int leafType = LEAF_TYPE_TOKENS; for (int layer = 0; layer < maxWindowLayerCount; layer++) { int type = typeOfLayer(policy, layer); if (leafArea == null || leafArea.mParent != areaForLayer[layer] || type != leafType) { leafArea = new PendingArea(null, layer, areaForLayer[layer]); areaForLayer[layer].mChildren.add(leafArea); leafType = type; if (leafType == LEAF_TYPE_TASK_CONTAINERS) { addTaskDisplayAreasToApplicationLayer(areaForLayer[layer]); leafArea.mSkipTokens = true; } else if (leafType == LEAF_TYPE_IME_CONTAINERS) { leafArea.mExisting = mImeContainer; leafArea.mSkipTokens = true; } } leafArea.mMaxLayer = layer; }

3. 调试技巧与实战验证

3.1 使用dumpsys验证层级结构

通过以下命令获取完整的DisplayArea树：

adb shell dumpsys window containers

典型输出示例：

DisplayArea 0-35 [WindowedMagnification] ├── DisplayArea 0-31 [WindowedMagnification] │ ├── DisplayArea 0-14 [HideDisplayCutout] │ │ ├── DisplayArea 0-23 [OneHanded] │ │ │ ├── DisplayArea 0-12 [FullscreenMagnification] │ │ │ │ ├── Leaf:0:12 │ │ │ │ └── TaskDisplayArea │ │ │ ├── DisplayArea 13-14 [ImePlaceholder] │ │ │ │ └── ImeContainer │ │ │ └── Leaf:15:23 │ │ └── Leaf:24:35 └── Leaf:32:35

3.2 关键断点设置

在Android Studio中调试时，建议设置以下关键断点：

DisplayContent.configureSurfaces()
DefaultProvider.instantiate()
DisplayAreaPolicyBuilder.build()
PendingArea.instantiateChildren()

调试时可重点关注以下变量：

mFeatures：当前配置的所有Feature
areaForLayer：各层级对应的PendingArea
mChildren：当前节点的子节点列表

4. 高级应用与自定义扩展

4.1 自定义Feature的实现

开发者可以通过继承DisplayAreaPolicy.Provider实现自定义策略：

public class CustomPolicyProvider extends DisplayAreaPolicy.Provider { @Override public DisplayAreaPolicy instantiate(WindowManagerService wmService, DisplayContent content, RootDisplayArea root, DisplayArea.Tokens imeContainer) { final HierarchyBuilder rootHierarchy = new HierarchyBuilder(root); // 添加自定义Feature rootHierarchy.addFeature(new Feature.Builder(...) .upTo(TYPE_SYSTEM_ALERT) .setNewDisplayAreaSupplier(DisplayArea.Dimmable::new) .build()); return new DisplayAreaPolicyBuilder() .setRootHierarchy(rootHierarchy) .build(wmService); } }

4.2 动态调整层级结构

在运行时动态调整DisplayArea层级：

// 获取DisplayContent实例 DisplayContent displayContent = mWmService.getDefaultDisplayContentLocked(); // 创建新的Feature Feature customFeature = new Feature.Builder(...).build(); // 重建策略 DisplayAreaPolicy newPolicy = new CustomPolicyProvider() .instantiate(mWmService, displayContent, displayContent, displayContent.mImeWindowsContainer); // 应用新策略 displayContent.setDisplayAreaPolicy(newPolicy);