第3章：SystemUI面板生命周期与Navigation生命周期的冲突点

3.1 面板生命周期的四个阶段

SystemUI中的每个面板（如通知面板、快捷设置面板、音量面板）都遵循独立但严格的生命周期管理。这四个阶段与Navigation组件的返回栈管理存在多处冲突，是面板导航整合的核心难点。

3.2 与Navigation生命周期的核心冲突点

Navigation组件基于Fragment的LifecycleOwner驱动，而SystemUI面板往往在窗口级（WindowManager、StatusBarWindowView）管理视图，两者生命周期不同步，导致以下四类冲突：

1. 创建时序错乱：面板onCreate()中尝试通过NavHostFragment.findNavController()获取NavController时，Fragment可能还未添加到FragmentManager。
2. 显示覆盖冲突：面板显示时如果自动navigate()到一个新目的地，会与当前返回栈目的地的onResume()产生竞态，导致面板无法正确接收返回事件。
3. 隐藏时转场打断：面板隐藏动画（如滑动退出）执行期间，Navigation的navAnim动画也会作用，两个动画同时修改视图变换矩阵，造成闪现或位置偏移。
4. 销毁时内存泄漏：面板持有NavController引用并在onDestroy()中未清理，当Navigation宿主Fragment已销毁但面板窗口延迟释放时，NavController继续收到生命周期事件导致崩溃。

3.3 冲突点流程图（SVG）

3.4 关键冲突代码表现

以下代码示例展示典型的创建时序错乱问题：面板onCreate()中过早尝试导航会抛出IllegalStateException。

// 问题代码：PanelViewController的onCreate中直接使用NavController
@Override
public void onCreate() {
    super.onCreate();
    // NavHostFragment可能还处于INITIALIZED状态
    NavController navController = Navigation.findNavController(activity, R.id.nav_host_fragment);
    // 抛出：NavigationController not found for NavHostFragment
    navController.navigate(R.id.action_from_panel);
}

// 正确做法：使用OnDestinationChangedListener延迟到Fragment onResume之后
@Override
public void onStart() {
    super.onStart();
    NavHostFragment navHost = (NavHostFragment) activity.getSupportFragmentManager()
            .findFragmentById(R.id.nav_host_fragment);
    if (navHost != null) {
        navHost.getNavController().addOnDestinationChangedListener((controller, destination, arguments) -> {
            if (destination.getId() == R.id.mainFragment) {
                // 面板与导航就绪后执行
                updatePanelUI();
            }
        });
    }
}

3.5 调试与定位冲突

• 使用 adb shell dumpsys activity 查看FragmentManager状态和返回栈。
• 在面板生命周期回调中添加日志：Log.d("PanelLifecycle", "onCreate: panelWindowToken=" + getWindowToken())。
• 打开Navigation的调试选项：NavController.enableGraphDebug(true) 可输出导航转换日志。
• 常见错误日志关键字：NavigationController not found、IllegalStateException: Fragment not attached to Activity、Animation canceled。

3.6 性能与稳定性优化建议

1. 延迟获取NavController：将依赖Navigation的初始化逻辑推迟到面板onStart()之后，且确保Fragment处于RESUMED状态。
2. 动画互斥AnimatorSet协调，或在面板隐藏前取消Navigation的动画。
3. WeakReference持有：面板持有NavController时使用WeakReference<NavController>，避免阻止宿主Fragment回收。
4. LifecycleObserver解耦：面板使用Lifecycle.Event.ON_DESTROY移除所有Navigation监听器。

// 面板中安全的NavController引用方式
private WeakReference navControllerRef;

@Override
public void onStart() {
    super.onStart();
    Fragment navFragment = activity.getSupportFragmentManager().findFragmentById(R.id.nav_host_fragment);
    if (navFragment instanceof NavHostFragment) {
        navControllerRef = new WeakReference<>(((NavHostFragment) navFragment).getNavController());
    }
}

// 在面板销毁时清理
@Override
public void onDestroy() {
    super.onDestroy();
    if (navControllerRef != null) {
        navControllerRef.clear();
    }
}