SwiftMessages 在 SwiftUI 中如何正确处理与系统弹窗的层级关系

在 iOS 应用开发中，消息提示和系统弹窗的层级关系是一个常见的 UI 交互问题。当使用 SwiftMessages 这个流行的消息提示库与 SwiftUI 的原生 Alert 或 ConfirmationDialog 结合使用时，开发者可能会遇到消息提示覆盖系统弹窗的问题。

问题背景

SwiftMessages 默认会在独立的窗口层级中显示消息提示，这可能导致消息提示出现在系统弹窗之上，破坏了正常的用户体验流程。在 UIKit 中，我们可以通过设置窗口层级来解决这个问题，但在 SwiftUI 中情况有所不同。

技术分析

SwiftUI 的系统弹窗（如 Alert 和 ConfirmationDialog）并不像 UIKit 那样使用独立的窗口层级。这些弹窗实际上是作为视图层级的一部分呈现的，而不是在单独的窗口层级中。这就解释了为什么即使将 SwiftMessages 的窗口层级设置为 .normal，消息提示仍然会出现在系统弹窗之上。

解决方案

要解决这个问题，我们需要让 SwiftMessages 的消息提示在当前视图控制器的视图层级中显示，而不是在独立的窗口中。以下是实现这一目标的关键步骤：

1. 获取当前窗口的根视图控制器：通过访问应用程序的窗口场景来获取当前活跃的窗口及其根视图控制器。

2. 设置 SwiftMessages 的呈现上下文：将获取到的视图控制器设置为 SwiftMessages 的呈现上下文。

3. 配置消息提示的显示样式：根据需要设置消息提示的显示位置、持续时间和交互方式。

实现代码示例

import SwiftUI
import SwiftMessages

struct MessageView: View {
    @State private var showAlert = false
    @State private var message: String?
    
    var body: some View {
        Button("显示消息和弹窗") {
            message = "这是一个测试消息"
            DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
                showAlert = true
            }
        }
        .swiftMessage(item: $message, config: messageConfig) { message in
            Text(message)
                .padding()
                .background(Color.yellow)
                .cornerRadius(10)
        }
        .alert("系统弹窗", isPresented: $showAlert) {
            Button("确定") { showAlert = false }
        }
    }
    
    private var messageConfig: SwiftMessages.Config {
        var config = SwiftMessages.Config()
        config.presentationStyle = .center
        config.duration = .forever
        
        if let rootVC = UIWindow.keyWindow?.rootViewController {
            config.presentationContext = .viewController(rootVC)
        }
        
        return config
    }
}

extension UIWindow {
    static var keyWindow: UIWindow? {
        UIApplication.shared.connectedScenes
            .sorted { $0.activationState.sortPriority < $1.activationState.sortPriority }
            .compactMap { $0 as? UIWindowScene }
            .compactMap { $0.windows.first { $0.isKeyWindow } }
            .first
    }
}

extension UIScene.ActivationState {
    var sortPriority: Int {
        switch self {
        case .foregroundActive: return 1
        case .foregroundInactive: return 2
        case .background: return 3
        case .unattached: return 4
        @unknown default: return 5
        }
    }
}

关键点说明

1. 窗口层级获取：通过扩展 UIWindow 添加了 keyWindow 属性，用于获取当前活跃的窗口。

2. 激活状态排序：为 UIScene.ActivationState 添加了排序优先级，确保我们总是获取最前台的窗口。

3. 视图控制器上下文：将 SwiftMessages 的呈现上下文设置为当前窗口的根视图控制器，使消息提示成为视图层级的一部分。

4. 延迟显示弹窗：示例中使用了短暂的延迟来确保消息提示先显示，然后系统弹窗出现，验证了层级关系的正确性。

最佳实践建议

1. 上下文一致性：在复杂的视图层级中，可能需要更精确地获取目标视图控制器，而不仅仅是根视图控制器。

2. 样式自定义：根据应用设计风格调整消息提示的视觉样式，确保与系统弹窗有明显区分。

3. 交互测试：在各种场景下测试消息提示与系统弹窗的交互，包括旋转设备、多任务处理等情况。

4. 内存管理：注意强引用问题，特别是在获取和保留视图控制器引用时。

通过这种方法，开发者可以确保 SwiftMessages 的消息提示在 SwiftUI 应用中正确地出现在系统弹窗之下，提供更加自然和符合预期的用户体验。