在 Android 17 的 libs/WindowManager/Shell/src/com/android/wm/shell/desktopmode/ 源码目录中,桌面模式(Desktop Windowing)的架构设计已经相当庞大且模块化。
结合您提供的子目录结构,以下是对各个核心子目录及模块的详细代码分析:
一、 animation/ (动画控制子系统)
-
核心职责:管理应用在全屏模式与桌面自由窗口(Freeform)形态之间转换时的视觉动画。
-
主要文件:
-
EnterDesktopTaskAnimator.kt:处理应用进入桌面模式时的放大、浮起或淡入动画。 -
DesktopToFullscreenTaskAnimator.kt:处理从桌面窗口还原回全屏时的收起与过渡动画。
-
二、 api/ 及 api/impl/ (对外接口与 AIDL 层)
-
核心职责:向 SystemUI 的其他组件(如任务栏、最近任务视图)或外部服务提供标准化、跨进程/进程内的通信接口。
-
主要文件:
-
IDesktopMode.aidl:定义系统级桌面模式控制的 AIDL 接口。 -
DesktopMode.java与impl/DesktopModeImpl.kt:接口的具体实现和包装类,解耦了 WMShell 内部实现与外部调用。
-
三、 clientfullscreenrequest/ (客户端全屏请求)
-
核心职责:处理来自应用客户端(Client App)主动发起的全屏或退出全屏请求。在桌面模式下,某些应用可能会请求改变自身的窗口状态,该目录下的
DesktopFullscreenRequestHandler.kt负责拦截、校验并协调这些全屏申请与当前桌面布局的关系。
四、 common/ (公共工具类)
-
核心职责:存放桌面模式全局复用的通用逻辑和辅助工具。
-
主要文件:
-
DefaultHomePackageSupplier.kt:提供默认桌面(Launcher)包名的供应器。 -
ToggleTaskSizeUtils.kt:处理窗口尺寸切换(如最大化与常规尺寸互换)的几何计算工具。
-
五、 compatui/ (兼容性 UI 与过渡)
-
核心职责:处理非完全适配桌面模式的应用(如强制竖屏的手机应用、游戏)在自由窗口中的兼容性展示与过渡。
-
主要文件:
-
SystemModalsTransitionHandler.kt:管理系统模态对话框或兼容性提示 UI 的转场动画。
-
六、 data/ 及 data/persistence/ (状态数据与持久化)
-
核心职责:管理桌面运行时的任务状态,并支持将用户的桌面窗口布局持久化保存。
-
主要文件:
-
DesktopRepository.kt:内存中的桌面任务数据源,实时记录当前活跃的桌面 Task。 -
persistence/:包含DesktopPersistentRepository.kt以及persistent_desktop_repositories.proto,利用 Protocol Buffers 将桌面上打开的窗口位置、大小等状态序列化存储,实现设备重启或横竖屏切换后的布局恢复。
-
七、 desktopfirst/ (桌面优先模式策略)
-
核心职责:针对外接显示器或大屏折叠屏推出的“桌面优先(Desktop-First)”交互策略。
-
主要文件:
-
DesktopDisplayModeController.kt:管理不同显示屏的显示模式策略(区分触控优先与键鼠桌面优先)。 -
DesktopFirstListenerManager.kt:管理桌面优先模式下的事件监听与分发。
-
八、 desktoptaskshandlers/ (任务转场处理器)
-
核心职责:对接 Android WindowManager 的
Transitions机制,处理桌面模式下复杂的窗口变动事务。 -
主要文件:
-
DesktopTasksTransitionHandler.kt:统筹并执行桌面任务组在变动时的核心转场逻辑。
-
九、 desktopwallpaperactivity/ (桌面壁纸 Activity 管理)
-
核心职责:负责管理桌面模式专属的壁纸渲染 Activity。
-
主要文件:
-
DesktopWallpaperActivity.kt:为桌面环境提供独立的壁纸背景展示窗口,确保类似传统 PC 的桌面壁纸体验。
-
十、 education/ 及 education/data/proto/ (新手引导与教育系统)
-
核心职责:向首次使用桌面模式的用户提供交互引导(如如何通过顶部句柄拖拽、应用转网页等)。
-
主要文件:
-
AppHandleEducationController.kt/AppToWebEducationController.kt:控制引导气泡或动画的触发时机。 -
data/proto/windowing_education.proto:使用 Protobuf 记录用户的引导观看状态,防止重复打扰。
-
十一、 homescreenpeeking/ (桌面偷看/预览功能)
-
核心职责:实现类似桌面“偷看(Peek)主屏幕”的交互。
-
主要文件:
-
DesktopHomeScreenPeekController.kt与转场处理器:允许用户在操作自由窗口时,通过特定手势短暂透出底部的桌面主屏幕内容或小部件。
-
十二、 multidesks/ 及 multidesks/animation/ (多虚拟桌面系统)
-
核心职责:实现类似 Windows 虚拟桌面或 macOS Mission Control 的多工作区/多桌面管理能力。
-
主要文件:
-
DesksController.kt:多桌面的总控逻辑,管理多个 Desk 实例的创建、销毁与切换。 -
DesksOrganizer.kt&RootTaskDesksOrganizer.kt:在底层 WindowManager 树中组织不同虚拟桌面的 Root Task 容器。 -
animation/:包含DeskSwitchAnimationUtils.kt与DeskWallpaperAnimator.kt,负责多个桌面之间平滑切换的壁纸动画与视觉过渡。
-
519



被折叠的 条评论
为什么被折叠?



