AOSP 13 分屏源码分析

binderIPC2026-07-02 10:59

AOSP 13 分屏源码分析

本文档基于 AOSP 13 源码，梳理系统级分屏（Split Screen）的架构、核心类、进入/退出流程及调试方法。

1. 概述

AOSP 13 的分屏实现已从传统 SystemUI View 迁移到 WM Shell（WindowManager Shell）。

  • SystemUI ：托管 Shell 进程、桥接 Launcher，不包含分屏核心 UI 逻辑
  • WM Shell：Stage 管理、分割线、窗口 bounds、过渡动画
  • Launcher3 Quickstep：分屏选择 UI、动画、跨进程调用 Shell
  • system_server ：Task 树、WINDOWING_MODE_MULTI_WINDOW、应用 WindowContainerTransaction

注意 ：SystemUI 中的 SplitShade*、SplitClockView 是通知栏分屏布局 ，与多窗口分屏无关。

WindowManager/Jetpack/ 下的 SplitPairRule 属于 Activity Embedding（应用内分屏），与系统分屏是两套机制。

2. 整体架构

#mermaid-svg-p8QMXwNxyOqBVSrR{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-p8QMXwNxyOqBVSrR .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-p8QMXwNxyOqBVSrR .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-p8QMXwNxyOqBVSrR .error-icon{fill:#552222;}#mermaid-svg-p8QMXwNxyOqBVSrR .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-p8QMXwNxyOqBVSrR .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-p8QMXwNxyOqBVSrR .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-p8QMXwNxyOqBVSrR .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-p8QMXwNxyOqBVSrR .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-p8QMXwNxyOqBVSrR .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-p8QMXwNxyOqBVSrR .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-p8QMXwNxyOqBVSrR .marker{fill:#333333;stroke:#333333;}#mermaid-svg-p8QMXwNxyOqBVSrR .marker.cross{stroke:#333333;}#mermaid-svg-p8QMXwNxyOqBVSrR svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-p8QMXwNxyOqBVSrR p{margin:0;}#mermaid-svg-p8QMXwNxyOqBVSrR .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-p8QMXwNxyOqBVSrR .cluster-label text{fill:#333;}#mermaid-svg-p8QMXwNxyOqBVSrR .cluster-label span{color:#333;}#mermaid-svg-p8QMXwNxyOqBVSrR .cluster-label span p{background-color:transparent;}#mermaid-svg-p8QMXwNxyOqBVSrR .label text,#mermaid-svg-p8QMXwNxyOqBVSrR span{fill:#333;color:#333;}#mermaid-svg-p8QMXwNxyOqBVSrR .node rect,#mermaid-svg-p8QMXwNxyOqBVSrR .node circle,#mermaid-svg-p8QMXwNxyOqBVSrR .node ellipse,#mermaid-svg-p8QMXwNxyOqBVSrR .node polygon,#mermaid-svg-p8QMXwNxyOqBVSrR .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-p8QMXwNxyOqBVSrR .rough-node .label text,#mermaid-svg-p8QMXwNxyOqBVSrR .node .label text,#mermaid-svg-p8QMXwNxyOqBVSrR .image-shape .label,#mermaid-svg-p8QMXwNxyOqBVSrR .icon-shape .label{text-anchor:middle;}#mermaid-svg-p8QMXwNxyOqBVSrR .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-p8QMXwNxyOqBVSrR .rough-node .label,#mermaid-svg-p8QMXwNxyOqBVSrR .node .label,#mermaid-svg-p8QMXwNxyOqBVSrR .image-shape .label,#mermaid-svg-p8QMXwNxyOqBVSrR .icon-shape .label{text-align:center;}#mermaid-svg-p8QMXwNxyOqBVSrR .node.clickable{cursor:pointer;}#mermaid-svg-p8QMXwNxyOqBVSrR .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-p8QMXwNxyOqBVSrR .arrowheadPath{fill:#333333;}#mermaid-svg-p8QMXwNxyOqBVSrR .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-p8QMXwNxyOqBVSrR .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-p8QMXwNxyOqBVSrR .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-p8QMXwNxyOqBVSrR .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-p8QMXwNxyOqBVSrR .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-p8QMXwNxyOqBVSrR .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-p8QMXwNxyOqBVSrR .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-p8QMXwNxyOqBVSrR .cluster text{fill:#333;}#mermaid-svg-p8QMXwNxyOqBVSrR .cluster span{color:#333;}#mermaid-svg-p8QMXwNxyOqBVSrR div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-p8QMXwNxyOqBVSrR .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-p8QMXwNxyOqBVSrR rect.text{fill:none;stroke-width:0;}#mermaid-svg-p8QMXwNxyOqBVSrR .icon-shape,#mermaid-svg-p8QMXwNxyOqBVSrR .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-p8QMXwNxyOqBVSrR .icon-shape p,#mermaid-svg-p8QMXwNxyOqBVSrR .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-p8QMXwNxyOqBVSrR .icon-shape .label rect,#mermaid-svg-p8QMXwNxyOqBVSrR .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-p8QMXwNxyOqBVSrR .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-p8QMXwNxyOqBVSrR .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-p8QMXwNxyOqBVSrR :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} system_server
WM Shell
SystemUI
Launcher3 Quickstep
用户触发
ISplitScreen AIDL
WindowContainerTransaction
最近任务、长按图标
Taskbar 拖拽
键盘快捷键
RecentsView
SplitSelectStateController
SystemUiProxy
SystemUIService
WMShell
OverviewProxyService
SplitScreenController
StageCoordinator
MainStage + SideStage
SplitLayout + DividerView
TaskOrganizerController
WindowOrganizerController

层级 职责
Launcher3 分屏选择 UI、动画、调用 ISplitScreen.startTasks()
SystemUI 启动 WM Shell，把 ISplitScreen Binder 传给 Launcher
WM Shell Stage 管理、分割线、窗口 bounds、过渡动画
system_server Task 树、WINDOWING_MODE_MULTI_WINDOW、应用 WCT

3. 核心目录

路径 内容
frameworks/base/libs/WindowManager/Shell/src/com/android/wm/shell/splitscreen/ 分屏核心逻辑
frameworks/base/libs/WindowManager/Shell/src/com/android/wm/shell/common/split/ 分割线、布局计算
frameworks/base/libs/WindowManager/Shell/src/com/android/wm/shell/draganddrop/ 拖拽进入分屏
packages/apps/Launcher3/quickstep/ 最近任务分屏 UI 与状态机
frameworks/base/services/core/java/com/android/server/wm/ Task/Window 策略
frameworks/base/packages/SystemUI/src/com/android/systemui/wmshell/ Shell 生命周期托管

4. Task 层级模型

StageCoordinator 定义了分屏的核心规则：

  • SideStage 有子任务 → 分屏才算激活
  • MainStage 有子任务 → 仅在 Coordinator 激活时
  • MainStage 与 SideStage 都可见 → 分割线才显示
  • 两个 Stage 放在同一个 single-top root task 下

实际窗口树结构：

复制代码 
Display
└── Split Root Task (single-top, mRootTaskInfo)
    ├── MainStage root (WINDOWING_MODE_MULTI_WINDOW)  ← 默认启动目标
    │   └── App Task
    ├── SideStage root (WINDOWING_MODE_MULTI_WINDOW)  ← 用户显式选中的任务
    │   └── App Task
    └── Divider (TYPE_DOCK_DIVIDER, DividerView)

启动时通过 ActivityOptions.KEY_LAUNCH_ROOT_TASK_TOKEN 指定任务进入哪个 Stage。

5. 关键类职责

5.1 WM Shell 层

类 文件 职责
SplitScreenController splitscreen/SplitScreenController.java 顶层入口，实现 ISplitScreen AIDL
StageCoordinator splitscreen/StageCoordinator.java 核心编排器：WCT 构建、进入/退出、Stage 协调
MainStage splitscreen/MainStage.java 主 Stage，默认 launch 目标
SideStage splitscreen/SideStage.java 副 Stage，用户显式 pin 的任务
StageTaskListener splitscreen/StageTaskListener.java 通过 ShellTaskOrganizer 创建 MULTI_WINDOW root task
SplitLayout common/split/SplitLayout.java 计算 bounds、分割线位置、拖拽 dismiss
DividerView common/split/DividerView.java 分割线触摸（拖动/双击）
SplitWindowManager common/split/SplitWindowManager.java 托管 TYPE_DOCK_DIVIDER 窗口
SplitScreenTransitions splitscreen/SplitScreenTransitions.java 分屏过渡动画
DragAndDropController draganddrop/DragAndDropController.java 拖拽进入分屏

5.2 Launcher 层

类 文件 职责
SplitSelectStateController util/SplitSelectStateController.java 分屏选择状态机，记录第一个/第二个 App
RecentsView views/RecentsView.java initiateSplitSelect() / confirmSplitSelect()
SystemUiProxy SystemUiProxy.java 封装 ISplitScreen 跨进程调用
SplitScreenSelectState uioverrides/states/SplitScreenSelectState.java Overview 中选第二个 App 时的 UI 状态
SplitShortcut.kt splitscreen/SplitShortcut.kt 桌面/All Apps 长按分屏
GroupedTaskView views/GroupedTaskView.java 重新启动已有分屏对
TopTaskTracker TopTaskTracker.java 实现 ISplitScreenListener，跟踪 Stage 任务

5.3 SystemUI 层

类 文件 职责
SystemUIService SystemUIService.java SystemUI 进程启动，间接启动 WMShell
WMShell wmshell/WMShell.java Shell 生命周期桥接（唤醒、全屏退出）
SystemUIInitializer SystemUIInitializer.java 构建 WMComponent，注入 SplitScreen

5.4 system_server 层

类 文件 职责
TaskOrganizerController server/wm/TaskOrganizerController.java Shell task organizer IPC
WindowOrganizerController server/wm/WindowOrganizerController.java 应用 WCT（reparent、bounds、launch）
TaskDisplayArea server/wm/TaskDisplayArea.java 创建 multi-window root task
RecentTasks server/wm/RecentTasks.java 分屏对分组显示在最近任务

6. 跨进程 API：ISplitScreen.aidl

Launcher 与 Shell 通过 AIDL 通信，Binder key 为 KEY_EXTRA_SHELL_SPLIT_SCREEN。

核心方法：

java 复制代码 
// 同时启动两个 task 进入分屏
oneway void startTasks(int taskId1, in Bundle options1, int taskId2, in Bundle options2,
        int splitPosition, float splitRatio, in RemoteTransition remoteTransition,
        in InstanceId instanceId);

// 启动 Intent + Task
oneway void startIntentAndTask(in PendingIntent pendingIntent, in Bundle options1, int taskId,
        in Bundle options2, int sidePosition, float splitRatio,
        in RemoteTransition remoteTransition, in InstanceId instanceId);

// 退出分屏
oneway void exitSplitScreen(int toTopTaskId);

// 注册监听
oneway void registerSplitScreenListener(in ISplitScreenListener listener);

文件路径：

frameworks/base/libs/WindowManager/Shell/src/com/android/wm/shell/splitscreen/ISplitScreen.aidl

7. 进入分屏流程

7.1 触发方式

方式 入口
最近任务菜单 TaskShortcutFactory → TaskView.initiateSplitSelect()
Overview 卡片 Split 按钮 RecentsView.initiateSplitSelect(TaskView)
桌面/All Apps 长按 SplitShortcut.kt → SplitScreenSelectState
Taskbar 拖拽 DragAndDropController → DragAndDropPolicy
键盘快捷键 SplitWithKeyboardShortcutController
重新启动已有分屏对 GroupedTaskView.launchTasks()
通知拖拽 DragAndDropController 同一套流程
ADB 调试 SplitScreenShellCommandHandler（cmd splitscreen）

7.2 两 App 选择流程（最常见）

Step 1 --- 选第一个 App
复制代码 
RecentsView.initiateSplitSelect()
  → SplitSelectStateController.setInitialTaskSelect()
  → Launcher 进入 SplitScreenSelectState（显示第一个 App 占位 UI）
Step 2 --- 选第二个 App
复制代码 
RecentsView.confirmSplitSelect()
  → SplitSelectStateController.launchSplitTasks()
  → launchTasks(taskId1, intent1, taskId2, intent2, stagePosition, ...)
Step 3 --- Launcher → Shell
复制代码 
SystemUiProxy.startTasks(taskId1, options1, taskId2, options2,
        splitPosition, splitRatio, remoteTransition, instanceId)
  → ISplitScreen.startTasks() [Binder 跨进程]
Step 4 --- Shell 构建 WCT

StageCoordinator.startTasks() 核心逻辑：

  1. setSideStagePosition(splitPosition, wct) --- 设置 SideStage 位置（上/左 或 下/右）
  2. 第一个 task → SideStage：addActivityOptions(options1, mSideStage) + wct.startTask(taskId1, options1)
  3. startWithTask() 处理第二个 task：
    • mMainStage.activate(wct, false) --- 激活 MainStage
    • mSplitLayout.setDivideRatio(splitRatio) --- 设置分割比例
    • updateWindowBounds(mSplitLayout, wct) --- 计算各 Stage bounds
    • 第二个 task → MainStage：addActivityOptions(mainOptions, mMainStage) + wct.startTask(mainTaskId, mainOptions)
    • SplitScreenTransitions.startEnterTransition(TRANSIT_SPLIT_SCREEN_PAIR_OPEN, ...)
Step 5 --- system_server 应用 WCT
复制代码 
WindowOrganizerController.applyTransaction(wct)
  → Task reparent 到 WINDOWING_MODE_MULTI_WINDOW root
  → TaskOrganizerController 回调 Shell（ShellTaskOrganizer）
Step 6 --- 完成进入

StageCoordinator.finishEnterSplitScreen()：

  1. mSplitLayout.init() --- 初始化 bounds
  2. setDividerVisibility(true, t) --- 显示分割线
  3. updateSurfaceBounds() --- 更新 Surface bounds
  4. updateRecentTasksSplitPair() --- 注册分屏对到 RecentTasks

7.3 拖拽进入分屏

复制代码 
用户拖拽 App 图标
  → DragAndDropController 显示 DragLayout（分屏区域）
  → DragAndDropPolicy 解析目标（左/右/上/下）
  → SplitScreenController.startIntent() / startTask()
  → StageCoordinator.prepareEnterSplitScreen() + launch

7.4 将已有 Task 移入分屏

复制代码 
SplitScreenController.enterSplitScreen(taskId, leftOrTop)
  → moveToStage()
  → prepareEnterSplitScreen(wct, taskInfo, startPosition)

8. 退出分屏

常见退出原因（SplitScreenController 定义）：

常量 含义
EXIT_REASON_DRAG_DIVIDER 拖动分割线超过阈值 dismiss 一侧
EXIT_REASON_RETURN_HOME 返回桌面
EXIT_REASON_APP_FINISHED App 结束
EXIT_REASON_DEVICE_FOLDED 折叠屏折叠
EXIT_REASON_APP_DOES_NOT_SUPPORT_MULTIWINDOW App 不支持多窗口
EXIT_REASON_CHILD_TASK_ENTER_PIP 子任务进入 PiP
EXIT_REASON_FULLSCREEN_SHORTCUT 全屏快捷键
EXIT_REASON_SCREEN_LOCKED_SHOW_ON_TOP 锁屏 show-on-top
EXIT_REASON_ROOT_TASK_VANISHED Root task 消失

9. 类关系图

复制代码 
SplitScreen (interface)
    ↑ implemented by SplitScreenController
        ├── StageCoordinator (core logic)
        │     ├── MainStage extends StageTaskListener
        │     ├── SideStage extends StageTaskListener
        │     ├── SplitLayout implements SplitLayoutHandler
        │     │     └── SplitWindowManager → DividerView
        │     └── SplitScreenTransitions
        ├── DragAndDropController (drag-to-split)
        └── ISplitScreenImpl (AIDL stub)

StageTaskListener
    └── ShellTaskOrganizer.createRootTask(MULTI_WINDOW)
        ↔ TaskOrganizerController (system_server)

Launcher side:
SplitSelectStateController → SystemUiProxy → ISplitScreen
TopTaskTracker extends ISplitScreenListener
RecentsView ↔ SplitSelectStateController ↔ SplitScreenSelectState

10. 调试方法

10.1 ADB 命令

bash 复制代码 
adb shell cmd splitscreen help

10.2 Logcat 过滤

bash 复制代码 
adb logcat -s StageCoordinator SplitScreenController SplitSelectStateController

10.3 排查优先级

问题类型 优先查看
分屏行为、WCT StageCoordinator.java
用户入口、动画 SplitSelectStateController.java
分割线交互 SplitLayout.java + DividerView.java
Task 树策略 TaskOrganizerController.java / WindowOrganizerController.java
Launcher 绑定 SystemUiProxy.java + TouchInteractionService.java

11. 关键源码索引

功能 文件 关键方法
启动两个 task StageCoordinator.java startTasks()
完成进入分屏 StageCoordinator.java finishEnterSplitScreen()
准备进入分屏 StageCoordinator.java prepareEnterSplitScreen()
Launcher 发起分屏 SplitSelectStateController.java launchSplitTasks() / launchTasks()
跨进程调用 SystemUiProxy.java startTasks()
分屏 API 定义 ISplitScreen.aidl startTasks(), exitSplitScreen()
布局计算 SplitLayout.java init(), setDivideRatio()
分割线 UI DividerView.java 触摸 drag / double-tap
Shell 托管 WMShell.java initSplitScreen()
热门推荐
012026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf022026年6月AI大模型全景报告：GPT-5.6、Claude Opus 4.8、Gemini 3.5，中美AI三足鼎立谁主沉浮？03GitHub 镜像站点042026年6月AI行业全景：从百模大战到Agent元年，这30天发生了什么？05【AI】2026 年具身智能模型和世界模型总结06Trae国际版与国内版深度测评：AI原生IDE的双生花07Claude Code、Codex、Cursor三分天下：2026年AI编程Agent生态全景剖析082026 AI 编程工具终极实战指南：Cursor vs Claude Code vs Copilot，开发者该怎么选？09飞书长连接_事件订阅（接收消息，审批任务状态变更）102026 年 AI 大模型 & AI 编程工具实战全总结