1. SystemUI 面板架构概览

SystemUI 是 Android 系统中负责用户界面导航与信息呈现的核心进程。它运行于独立的系统进程，与 Framework 服务通过 Binder 和回调通信。本章从架构分层、组件树、导航组件集成三个维度建立全景认知，为后续导航深度整合铺设基础。

1.1 整体架构分层

SystemUI 的软件架构遵循“数据源 → 中介层 → 视图”的三层模型。底层由 SystemUI 内部的 Dependency 依赖注入框架提供全局单例；中间层通过 CommandQueue 接收来自 SystemServer 的指令；顶层由 WindowManager 管理的 StatusBarWindowView、NavigationBarView 等视图构成。

1.2 面板组件层次

面板组件按显示优先级和窗口类型组织：

• 状态栏（StatusBar）：顶层窗口，显示通知图标、系统状态、时钟。包含 PhoneStatusBarView 和 NotificationPanelView。
• 导航栏（NavigationBar）：底栏窗口，手势/按键导航。从 Android 10 起支持完全手势模式，NavigationBarView 内部包含 NavigationBarInflaterView。
• 快捷面板（QuickSettingsPanel）：下拉展开后的控制中心，由 QSFragment 和 QSContainerImpl 组成。
• 锁屏（Keyguard）：覆盖在状态栏之上的安全浮层，独立于 Navigation。

上述面板的实例化与生命周期由 SystemUIFactory 统一管理，并在 StatusBarWindowManager 中注册窗口令牌。

1.3 Navigation 组件角色

Jetpack Navigation 在 SystemUI 中负责管理面板内 Fragment 的切换，尤其是需要动态替换内容的面板（如快捷面板内的二级页面、助手的嵌入式片段）。

• NavHost：每个面板窗口对应一个 NavHostFragment，嵌入在 FrameLayout 中。
• NavController：通过 Navigation.findNavController(view) 获取，执行 navigate() 或 popBackStack()。
• NavGraph：使用 XML 资源文件（@navigation/qs_nav_graph）声明目的地和 action。

1.4 整合目标定义

本课程通过将 Jetpack Navigation 深度嵌入 SystemUI 面板组件，达成以下整合目标：

1. 统一导航栈：所有面板内的 Fragment 切换共享同一个 NavController，消除手写 FragmentTransaction 的碎片化。
2. 支持深层链接：外部广播（如“打开辅助功能设置”）可直接路由到面板内的指定 Fragment。
3. 减少内存泄漏：利用 Navigation 的自动 backstack 清理和生命周期绑定。
4. 可测试性提升：NavGraph 的 XML 描述使导航路线可视化，可编写独立测试验证。

下图展示了 SystemUI 整体架构中主要组件之间的依赖关系与导航节点位置：

1.5 开发环境准备

在开始面板导航整合前，确保环境满足以下要求：

• AOSP 源码分支：android-14.0.0_r35 或更新（推荐）
• 构建命令：source build/envsetup.sh && lunch aosp_arm64-userdebug && m SystemUI
• 依赖库：Jetpack Navigation 2.6+（已预置在 frameworks/base 的 dependencies 中）

// 检查 navigation-common 是否已包含
// 在 SystemUI/Android.bp 中应有如下依赖（典型片段）：
android_app {
    name: "SystemUI",
    static_libs: [
        "androidx.navigation_navigation-fragment",
        "androidx.navigation_navigation-ui",
    ],
    // ...
}

1.6 常见问题与规避