如何设置Mac Catalyst窗口初始背景色？解决模态视图闪白问题

核心问题 #

Mac Catalyst在处理模态视图（弹窗、popover）时，会在视图控制器的viewDidLoad等回调之前就渲染容器视图的背景，此时会优先使用系统主题的颜色，导致浅色系统主题下出现白色闪屏——哪怕后续设置了overrideUserInterfaceStyle和背景色，也会因为时机太晚产生视觉延迟。

可行解决方案 #

1. 全局设置窗口的深色主题与背景色

在SceneDelegate的scene:willConnectTo:options:中，同时设置窗口的强制深色主题和背景色，从底层覆盖系统默认的浅色背景：

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let windowScene = (scene as? UIWindowScene) else { return }
    let window = UIWindow(windowScene: windowScene)
    self.window = window
    
    // 全局强制深色主题
    window.overrideUserInterfaceStyle = .dark
    // 设为你的深色背景色，避免容器初始显示白色
    window.backgroundColor = App.bgColor
    
    let mainVC = MainViewController()
    window.rootViewController = mainVC
    window.makeKeyAndVisible()
}

2. 自定义过渡代理，提前设置容器背景

通过自定义UIViewControllerTransitioningDelegate，在模态容器视图创建初期就设置背景色，规避加载延迟：

class DarkModalTransitionDelegate: NSObject, UIViewControllerTransitioningDelegate {
    func presentationController(forPresented presented: UIViewController, presenting: UIViewController?, source: UIViewController) -> UIPresentationController? {
        let presentationController = UIPresentationController(presentedViewController: presented, presenting: presenting)
        // 提前给容器视图设置深色背景
        presentationController.containerView?.backgroundColor = App.bgColor
        return presentationController
    }
}

使用时直接绑定到模态视图控制器：

let testVC = UIViewController()
testVC.overrideUserInterfaceStyle = .dark
testVC.view.backgroundColor = App.bgColor
testVC.transitioningDelegate = DarkModalTransitionDelegate()
App.mainViewController.present(testVC, animated: true)

3. Popover专属处理

针对popover消失时的白色闪屏，需要直接设置popoverPresentationController的背景色：

let popoverVC = UIViewController()
popoverVC.overrideUserInterfaceStyle = .dark
popoverVC.view.backgroundColor = App.bgColor

if let popover = popoverVC.popoverPresentationController {
    // 强制popover背景为深色，避免消失时闪白
    popover.backgroundColor = App.bgColor
}
App.mainViewController.present(popoverVC, animated: true)

4. 更早的生命周期钩子设置背景

将背景色和主题设置提前到init或loadView阶段，避开viewDidLoad的延迟：

class DarkModalVC: UIViewController {
    override init(nibName nibNameOrNil: String?, bundle nibBundleOrNil: Bundle?) {
        super.init(nibName: nibNameOrNil, bundle: nibBundleOrNil)
        overrideUserInterfaceStyle = .dark
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        overrideUserInterfaceStyle = .dark
    }
    
    override func loadView() {
        super.loadView()
        view.backgroundColor = App.bgColor
    }
}

总结 #

iOS上只需全局设置窗口的overrideUserInterfaceStyle即可解决问题，但Mac Catalyst需要多维度处理：全局窗口背景配置、提前设置模态容器背景、针对popover单独配置，以及在更早的生命周期节点设置视图属性，才能彻底消除白色闪屏问题。

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