按理说，

在 Android 12 程序里StatusBar是程序 UI 的主要组件。负责展示时间、网络、通知等关键信息，并提供下拉展开通知面板的交互入口。很多开发者在自定义 ROM、调试通知逻辑或实现特殊手势时都会碰到以下痛点：

• 难以定位触摸事件的传递方法：状态栏的触摸处理层层包装，直接定位到具体的 View 往往需要追踪多层父类。
• 面板展开高度计算不透明：面板展开过程涉及多段回调。若想动态控制高度或动画，需要了解内部方法的调用链。
• 自定义 UI 时缺少官方文档支持：SystemUI 并未提供完整的 API 文档。只有源码可以参考，导致二次开发成本高。

StatusBar 中通知面板显示流程

1. 触摸事件分发

1. 使用者触摸顶部状态栏：当使用者在屏幕顶部滑动时MotionEvent 由 PhoneStatusBarView 接收。该类重写了 onTouchEvent但实际主要原因位于其父类 PanelBar。
2. PanelBar 处理触摸：PanelBar.onTouchEvent 最终调用

   mPanel.getView.dispatchTouchEvent;

   将事件转发给对应的 PanelViewController 所持有的视图，即 NotificationPanelView。

// frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/phone/PanelBar.java
public boolean onTouchEvent {
// mPanel = PanelViewController 的抽象类，实现类为 NotificationPanelViewController
return mPanel == null || mPanel.getView.dispatchTouchEvent;}

2. 控制器计算展开高度

3. ACTION_MOVE 处理：NotificationPanelViewController 在收到 ACTION_MOVE 时会依据手指位置调用

   setExpandedHeightInternal;

   更新面板当前的展开高度。
4. 触发 panelExpansionChanged：`setExpandedHeightInternal` 内部会调用 `notifyBarPanelExpansionChanged`，进而触发 `PanelBar` 的 `panelExpansionChanged` 方法。
5. `PanelBar` 更新状态并回调：
   • If panel is transitioning from closed to opening,it executes:

     go;话说回来，onPanelPeeked;// 子类覆写的方法
     

   • `go` 会调用 ,标记面板正在打开。
   • `onPanelPeeked` 是一个空实现。由 覆写，在其中调用:

     mBar.makeExpandedVisible;

     这一步最终使得 可见，完成下拉面板的展示。

Pain Point 对应解决思路

• #1 触摸事件追踪：If you need to intercept or modify touch flow,hook into PANEL_BAR.onTouchEvent`PhoneStatusBarView` and override its `onTouchEvent` before delegating to super.
• #2 动态控制展开高度：You can call ``NotificationPanelViewController#setExpandedHeightInternal` directly from your custom service or use public `expandNotifications` API combined with `setForcePluginOpen` for forced expansion.
• #3 自定义 UI 可视化：The visibility of ``NotificationShadeWindowView` is toggled by `makeExpandedVisible`. Overriding this method allows you to inject custom animations or replace shade view entirely.

小结 & 推荐阅读资源

- 查看源码方法：

frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/phone/PhoneStatusBarView.java
frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/phone/NotificationPanelViewController.java
frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/phone/NotificationShadeWindowView.java

- 推荐阅读：Google 官方 Android 12 SystemUI 改动日志、AOSP 社区关于 PanelBar 的讨论贴。这些资源能方便你定位问题、降低二次开发成本。

- 若要在自定义 ROM 中安全地修改 StatusBar 行为。请确保在 **boot_completed** 后再进行 Hook，以避免程序初始化期间产生冲突。

end of document.