Capacitor自定义Swift插件：获取ViewController与AppDelegate窗口遇阻

问题背景 #

开发Capacitor插件时，调用第三方框架方法需要传入两个核心参数：

• restoreViewController：应用的原视图控制器
• window：AppDelegate持有的原窗口
  调用完成后还需要更新AppDelegate的window，但现有实现要么执行无效果，要么抛出Unbalanced calls to begin/end appearance transitions错误。

修正后的实现代码 #

// 确保在主线程执行UI操作（Capacitor插件可能在后台线程触发）
DispatchQueue.main.async {
    // 安全获取AppDelegate实例
    guard let appDelegate = UIApplication.shared.delegate as? AppDelegate else {
        print("Failed to get AppDelegate instance")
        return
    }
    
    // 确认原window存在，避免nil传递
    guard let originalWindow = appDelegate.window else {
        print("AppDelegate window is nil")
        return
    }
    
    // 用原window初始化目标变量，保证第三方框架能拿到有效窗口引用
    var targetWindow: UIWindow? = originalWindow
    
    // 调用第三方框架方法
    method(
        restoreViewController: originalWindow.rootViewController,
        window: &targetWindow
    )
    
    // 更新AppDelegate窗口并设置为活跃窗口
    if let updatedWindow = targetWindow {
        appDelegate.window = updatedWindow
        updatedWindow.makeKeyAndVisible()
    }
}

问题原因与解释 #

1. 原代码无效果的原因
   原代码中var window: UIWindow?初始化为nil，第三方框架无法基于nil窗口完成预期操作，导致执行后无效果。必须用AppDelegate的现有window初始化该变量，确保框架能拿到有效的窗口引用。

2. 视图过渡错误的原因
   使用self.bridge?.viewController时出现的Unbalanced calls错误，是因为该视图控制器可能正处于视图生命周期的过渡阶段（如页面跳转中），此时传递会干扰系统的视图状态管理。改用originalWindow.rootViewController（应用根视图控制器）能避免这个问题，因为根控制器的状态更稳定。

3. 必须调用makeKeyAndVisible()
   更新AppDelegate的window后，需要显式调用makeKeyAndVisible()，确保新窗口成为应用的主窗口并显示，否则系统可能不会切换到新窗口。

内容的提问来源于stack exchange，提问作者pb15