Android7 SystemUI 源码解析(一)全景概览与架构设计

系列导航 :一:全景概览与架构设计 | 二:启动流程深度解析(本文) | 三:StatusBar 状态栏 | 四:NavigationBar 导航栏 | 五:通知系统 | 六:QuickSettings | 七:Keyguard 锁屏 | 八:Recents 与其他子系统


一、SystemUI 是什么

SystemUI 全称 System User Interface ,直译为"系统用户界面"。它是 Android 系统中承载系统级交互与状态展示 的核心组件,我们日常看到的状态栏、导航栏、通知中心、锁屏界面、快捷设置面板、最近任务列表等,都属于 SystemUI 的范畴。

从技术角度看,SystemUI 是一个系统级 APK ,源码位于 frameworks/base/packages/SystemUI/ 下。

注意它不是放在 packages/apps/ 下,而是放在 frameworks/base/packages/ 下,这意味着 SystemUI 本质上属于 Framework 层 ,拥有系统签名(android:sharedUserId="android.uid.system"),可以直接与 WindowManagerService、ActivityManagerService、NotificationManagerService 等核心系统服务进行交互。

二、SystemUI 的核心职责

SystemUI 在 Android 系统中扮演着以下四个关键角色:

1. 状态呈现中心

实时展示系统关键状态信息:时间、电池电量、网络信号、Wi-Fi、蓝牙、闹钟、通知图标等。

2. 全局交互入口

提供用户与系统交互的关键通道:

  • 状态栏(StatusBar):下拉通知/快捷设置、显示状态图标
  • 导航栏(NavigationBar):返回、主页、最近任务(经典三键)
  • 锁屏(Keyguard):安全认证(PIN/图案/密码)、紧急呼叫、通知预览
  • 通知抽屉(NotificationPanel):集中管理所有应用通知
  • 快捷设置面板(QuickSettings):一键开关 Wi-Fi、蓝牙、飞行模式等

3. 安全边界守护者

在锁屏状态下充当安全屏障,控制对设备的访问,管理敏感通知的显示策略。

4. 沉浸式体验协调者

管理应用全屏模式下系统栏的显示与隐藏逻辑,处理 SYSTEM_UI_FLAG_FULLSCREEN、SYSTEM_UI_FLAG_HIDE_NAVIGATION、SYSTEM_UI_FLAG_IMMERSIVE_STICKY 等标志位。

三、源码目录结构总览

复制代码
frameworks/base/packages/SystemUI/
├── AndroidManifest.xml            # 应用清单(系统权限声明)
├── res/                           # 资源文件
│   ├── layout/                    # 布局文件(状态栏、导航栏、通知面板等)
│   ├── values/                    # 配置值
│   ├── drawable/                  # 图标资源
│   └── anim/                      # 动画资源
├── src/com/android/systemui/
│   ├── SystemUIService.java       # ★ 入口 Service
│   ├── SystemUIApplication.java   # ★ Application 类(定义 SERVICES 数组)
│   ├── SystemUI.java              # ★ 所有子模块的抽象基类
│   ├── SystemUIFactory.java       # 通过反射创建各子模块实例
│   ├── statusbar/                 # 状态栏 + 导航栏(SystemBars 在此)
│   │   ├── SystemBars.java        # ★ 状态栏/导航栏总控服务
│   │   ├── CommandQueue.java      # ★ 命令队列(与系统服务通信)
│   │   ├── BaseStatusBar.java     # 状态栏抽象基类
│   │   ├── phone/                 # 手机形态状态栏
│   │   │   ├── PhoneStatusBar.java        # ★ 状态栏核心
│   │   │   ├── NavigationBarView.java     # ★ 导航栏视图
│   │   │   ├── StatusBarWindowView.java
│   │   │   └── ...
│   │   └── policy/                # 按键策略
│   │       └── KeyButtonView.java
│   ├── keyguard/                  # 锁屏模块
│   │   ├── KeyguardViewMediator.java      # ★ 锁屏调度核心
│   │   └── ...
│   ├── tuner/                     # 开发者调试面板(TunerService)
│   ├── stackdivider/              # 分屏(Divider 在此)
│   │   └── Divider.java
│   ├── recents/                   # 最近任务模块
│   │   ├── Recents.java
│   │   └── RecentsActivity.java
│   ├── volume/                    # 音量控制模块
│   │   ├── VolumeUI.java
│   │   └── VolumeDialogController.java
│   ├── power/                     # 电源管理模块
│   │   └── PowerUI.java
│   ├── qs/                        # QuickSettings 快捷设置
│   │   ├── QSPanel.java
│   │   └── tiles/                 # 各种 Tile 实现
│   ├── media/                     # 铃声播放(RingtonePlayer)
│   ├── keyboard/                  # 键盘快捷键(KeyboardUI)
│   ├── shortcut/                  # 快捷键分发(ShortcutKeyDispatcher)
│   ├── tv/                        # TV 形态(tv.pip.PipUI)
│   └── usb/                       # USB 存储通知(StorageNotification)
└── tests/                         # 测试代码

关键 :statusbar/ 目录不仅管状态栏,SystemBars.java 同时负责状态栏和导航栏的创建与控制;stackdivider/ 和 tv/ 下的 PipUI 也属于子模块,目录名容易让人忽略它们。

四、AOSP7 SystemUI 子模块全景

在 AOSP7 中,SystemUI 的子模块组件列表不是 res/values/config.xml 里的 XML 字符串数组,而是硬编码 在 SystemUIApplication 里的一个 Class<?>[] 数组。启动时通过 SystemUIFactory 反射创建每个组件的实例,再逐一调用 start()。这个数组的定义如下:

源码路径 :frameworks/base/packages/SystemUI/src/com/android/systemui/SystemUIApplication.java

java 复制代码
public class SystemUIApplication extends Application {
    // ...
    private final Class<?>[] SERVICES = new Class[] {
            com.android.systemui.tuner.TunerService.class,
            com.android.systemui.keyguard.KeyguardViewMediator.class,
            com.android.systemui.recents.Recents.class,
            com.android.systemui.volume.VolumeUI.class,
            Divider.class,
            com.android.systemui.statusbar.SystemBars.class,
            com.android.systemui.usb.StorageNotification.class,
            com.android.systemui.power.PowerUI.class,
            com.android.systemui.media.RingtonePlayer.class,
            com.android.systemui.keyboard.KeyboardUI.class,
            com.android.systemui.tv.pip.PipUI.class,
            com.android.systemui.shortcut.ShortcutKeyDispatcher.class,
            com.android.systemui.VendorServices.class
    };
    // 每个用户单独启动的子集
    private final Class<?>[] SERVICES_PER_USER = new Class[] {
            com.android.systemui.recents.Recents.class,
            com.android.systemui.tv.pip.PipUI.class
    };
}

关键设计 :SERVICES 是硬编码的 Class<?>[],而非 XML 配置------子模块的增删要改这一处源码并重新编译,运行时无法动态调整;数组顺序即启动顺序。

每个组件都继承自 SystemUI 抽象基类,实现 start() 方法。

下表汇总各子模块的核心类与主要职责,按"系统栏 / 面板 / 周边子系统"的顺序排列:

模块 核心类 主要职责
StatusBar PhoneStatusBar 状态栏视图、通知图标、下拉手势
NavigationBar NavigationBarView 导航栏三键、布局管理
NotificationPanel NotificationPanelView 通知面板展开/折叠、通知条目管理
QuickSettings QSPanel / QSTileHost 快捷开关面板、Tile 增删改
Keyguard KeyguardViewMediator 锁屏调度、安全认证
Recents Recents 最近任务列表展示
VolumeUI VolumeUI 音量调节对话框
PowerUI PowerUI 低电量/过热警告
Divider Divider 分屏功能适配(AOSP7 新增)
Screenshot SaveImageInBackgroundTask 截屏保存与通知
RingtonePlayer RingtonePlayer 系统铃声播放

五、SystemUI 与系统服务的交互全景

SystemUI 不是一个孤立的模块,它与多个系统服务紧密协作。下图展示了核心交互关系:

复制代码
┌─────────────────────────────────────────────────────────────┐
│                     SystemServer 进程                        │
│  ┌──────────┐  ┌──────────┐  ┌──────────────────────┐      │
│  │   AMS    │  │   WMS    │  │NotificationManagerSvc │      │
│  └────┬─────┘  └────┬─────┘  └──────────┬───────────┘      │
│       │              │                   │                   │
│  ┌────┴──────────────┴───────────────────┴──────────┐      │
│  │            StatusBarManagerService               │      │
│  └────────────────────────┬─────────────────────────┘      │
└───────────────────────────┼────────────────────────────────┘
                            │ Binder IPC
┌───────────────────────────┼────────────────────────────────┐
│              SystemUI 进程 │                                │
│  ┌────────────────────────┴────────────────────────┐       │
│  │                 CommandQueue                     │       │
│  └────────┬──────────┬──────────┬──────────────────┘       │
│           │          │          │                           │
│  ┌────────┴──┐ ┌─────┴────┐ ┌──┴──────────┐               │
│  │PhoneStatus│ │ Keyguard │  │  Recents    │               │
│  │   Bar     │ │ ViewMed  │  │             │               │
│  └───────────┘ └──────────┘ └─────────────┘               │
└─────────────────────────────────────────────────────────────┘

关键交互说明:

  1. 与 WMS 交互 :SystemUI 通过 WindowManager.LayoutParams 创建系统级窗口(TYPE_STATUS_BAR、TYPE_NAVIGATION_BAR、TYPE_KEYGUARD_DIALOG),这些窗口具有最高显示优先级。

  2. 与 AMS 交互:获取当前前台应用信息、处理最近任务列表、响应系统配置变化。

  3. 与 NMS(NotificationManagerService)交互 :通过 StatusBarManagerService 作为桥梁,NMS 将通知信息传递给 SystemUI 的 CommandQueue,再由 PhoneStatusBar 渲染到状态栏和通知面板。

  4. 与 StatusBarManagerService 交互 :SystemUI 通过 CommandQueue 实现了 IStatusBar 接口,作为 NMS 的回调,接收通知增删、系统图标更新等指令。

  5. 与 PhoneWindowManager 交互:处理导航栏按键事件、沉浸式模式切换、锁屏/解锁状态的协调。

六、AOSP7 SystemUI 的版本特征

相比后续版本,AOSP7 的 SystemUI 有以下显著特征:

特征 AOSP7 AOSP8+
分屏功能 新增 Divider 模块 完善
画中画(PiP) 仅 TV 支持 8.0 手机全面支持
通知渠道 不支持 8.0 引入 NotificationChannel
锁屏通知 基础支持 8.0+ 更细粒度控制
快捷设置 基础 Tile 系统 9.0+ 更灵活的自定义

七、本系列文章阅读导航

篇目 标题 核心内容
一 全景概览与架构设计(本文) 模块定位、目录结构、子模块总览
二 启动流程深度解析 SystemServer→SystemUIService→startServicesIfNeeded
三 StatusBar 状态栏源码分析 PhoneStatusBar、makeStatusBarView、图标管理
四 NavigationBar 导航栏与 SystemBars NavigationBarView、KeyButtonView、沉浸式模式
五 通知系统:从 NMS 到 SystemUI 通知发送接收链路、NotificationEntry、通知面板
六 QuickSettings 快捷设置面板 QSPanel、QSTileHost、Tile 管理
七 Keyguard 锁屏模块深度解析 KeyguardViewMediator、安全锁屏/滑动锁屏
八 Recents 最近任务与其他子系统 Recents、VolumeUI、PowerUI、Screenshot、定制实战

八、写给读者

如果你是第一次接触 SystemUI 源码,建议先通读本文建立全局认知,然后按照从"启动流程"到"核心模块"再到"周边子系统"的顺序逐篇阅读。每篇文章都配有源码路径、关键代码片段和架构图,建议打开 AOSP 源码对照阅读,效果更佳。

学习建议:

  • 先理清 SystemUI.java 基类和 SystemUIApplication 的启动机制
  • 再深入 PhoneStatusBar 理解状态栏这一核心枢纽
  • 然后逐个模块突破,理解各模块之间的数据流转
  • 最后尝试做一个简单的定制修改(如修改状态栏图标、添加自定义 Tile)

下一篇:AOSP7 SystemUI 源码解析(二):启动流程深度解析,我们将从 SystemServer 的 startSystemUi() 开始,逐层追踪 SystemUI 的完整启动链路。

相关推荐
FungLeo12 小时前
FengCMS · PHP+MySQL 升级实录 · 危险默认值之殇:root/123456、认证码 8888 写进配置加载器
android·mysql·php·安全加固·fengcms
yz_aiks13 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
booboosui21 小时前
编号没变,消息还是来了:Mac 端通知读取漏第二条的原因
android
雨白2 天前
单例设计模式:从 Java/Kotlin 实现到 Android 实战
android
hai_android2 天前
一行 asLiveData,背后是一座生命周期的桥
android·java·kotlin
阿杰m2 天前
Android源码第二十三章:Telephony、RIL 与 IMS——来电怎么到应用?
android
booboosui2 天前
没人认领 .md:安卓把报告交给了音乐播放器打开
android
用户60709759149062 天前
AOSP 14 OTA 升级指导(四):update_engine 内部机制——Action 流水线与写盘
android
恋猫de小郭2 天前
Jetpack Compose 1.13 发布,憋了这么久终有交代了
android·前端·flutter
JMchen1232 天前
【Android 性能优化实战 60 讲】12 异步 Inflate 实战与痛击:源码拆解原生瓶颈,手写增强版布局预加载框架
android·性能优化·实战·启动优化·异步inflate·x2c