解决DoraemonKit在iOS13+导致NavigationBar显示异常的问题

问题背景

在使用DoraemonKit这款强大的iOS调试工具时，开发者可能会遇到一个常见的UI问题：在iOS13及以上系统中，引入DoraemonKit后会导致自定义NavigationController的导航栏显示异常，表现为界面内容整体上移，遮挡了导航栏区域。

问题现象

具体表现为：

1. 顶部导航栏(NavigationBar)显示异常
2. 自定义的NavigationController界面被整体上移
3. 在iOS12和iOS16设备上均会出现此问题

问题原因分析

经过深入排查，发现这是由于iOS13引入的SceneDelegate架构变化导致的初始化时机问题。在iOS13+系统中：

1. 应用启动流程从AppDelegate转移到了SceneDelegate
2. DoraemonKit内部有防止重复初始化的机制
3. 如果将DoraemonKit的安装方法install()放在scene(_:willConnectTo:options:)中，可能会因为初始化时机不当导致UI布局异常

解决方案

正确的做法是将DoraemonKit的安装方法调用放在SceneDelegate的活跃状态方法中，而不是willConnectTo方法中。具体修改如下：

// SceneDelegate.swift

// 错误做法（会导致UI问题）：
func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    #if DEBUG
    DoraemonManager.shareInstance().install()
    #endif
    // 其他初始化代码...
}

// 正确做法：
func sceneDidBecomeActive(_ scene: UIScene) {
    #if DEBUG
    DoraemonManager.shareInstance().install()
    #endif
    // 其他激活时代码...
}

技术原理

这种解决方案有效的根本原因在于：

1. UI布局完成时机：sceneDidBecomeActive是在UI布局完成之后调用的，此时再初始化调试工具不会干扰原有的布局计算
2. 单例初始化机制：DoraemonKit内部使用单例模式，确保只初始化一次，放在活跃状态方法中既保证了唯一性又不会过早干扰UI
3. 生命周期顺序：iOS13+的Scene生命周期中，willConnectTo调用时视图层级可能还未完全建立，而sceneDidBecomeActive时视图层级已经稳定

最佳实践建议

1. 环境判断：始终在DEBUG环境下才初始化DoraemonKit，避免影响生产环境
2. 版本兼容：对于支持多iOS版本的应用，建议在AppDelegate和SceneDelegate中都做好环境判断
3. 初始化位置：如果应用同时支持iOS12及以下版本，需要在AppDelegate的applicationDidBecomeActive中也添加相应代码

// AppDelegate.swift
func applicationDidBecomeActive(_ application: UIApplication) {
    #if DEBUG
    if #available(iOS 13.0, *) {
        // iOS13+在SceneDelegate中处理
    } else {
        DoraemonManager.shareInstance().install()
    }
    #endif
}

总结

DoraemonKit作为一款优秀的调试工具，在iOS13及以上的系统中使用时需要注意其初始化时机。通过将安装方法放在正确的生命周期方法中，可以避免UI布局问题，同时保证调试功能的正常使用。这一解决方案不仅适用于NavigationBar显示问题，也适用于其他类似的UI异常情况。