AOSP 13 分屏源码分析

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. 整体架构

3. 核心目录

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 层

5.2 Launcher 层

5.3 SystemUI 层

5.4 system_server 层

6. 跨进程 API：ISplitScreen.aidl

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

核心方法：

// 同时启动两个 task 进入分屏onewayvoidstartTasks(inttaskId1,inBundleoptions1,inttaskId2,inBundleoptions2,intsplitPosition,floatsplitRatio,inRemoteTransitionremoteTransition,inInstanceIdinstanceId);// 启动 Intent + TaskonewayvoidstartIntentAndTask(inPendingIntentpendingIntent,inBundleoptions1,inttaskId,inBundleoptions2,intsidePosition,floatsplitRatio,inRemoteTransitionremoteTransition,inInstanceIdinstanceId);// 退出分屏onewayvoidexitSplitScreen(inttoTopTaskId);// 注册监听onewayvoidregisterSplitScreenListener(inISplitScreenListenerlistener);

文件路径：
frameworks/base/libs/WindowManager/Shell/src/com/android/wm/shell/splitscreen/ISplitScreen.aidl

7. 进入分屏流程

7.1 触发方式

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定义）：

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 命令

adb shell cmd splitscreenhelp

10.2 Logcat 过滤

adb logcat-sStageCoordinator SplitScreenController SplitSelectStateController

10.3 排查优先级

11. 关键源码索引