Swift Composable Architecture 中 ConfirmationDialog 自动关闭问题解析

问题现象

在使用 Swift Composable Architecture (TCA) 框架开发 iOS 应用时，开发者可能会遇到一个奇怪的现象：当在 UIKit 环境中使用 observe 闭包展示确认对话框(ConfirmationDialog)时，对话框会在显示后立即自动关闭。更奇怪的是，后续尝试再次展示对话框时，控制台会显示警告信息："Attempt to present... while a presentation is in progress"。

问题根源

经过深入分析，这个问题实际上是由于错误地将 present 方法放在了 observe 闭包中导致的。在 TCA 的最新版本中，UIBindable 属性包装器已经能够自动处理这类视图控制器的展示逻辑，不需要再手动使用 observe 闭包。

解决方案

正确的做法是直接使用 UIBindable 属性包装器，而不需要额外的 observe 闭包。以下是修正后的代码示例：

final class ViewController: UIViewController {
    @UIBindable private var store = Store(initialState: MainFeature.State()) {
        MainFeature()
    }
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        let button = UIButton(primaryAction: UIAction { [weak self] _ in
            self?.store.send(.buttonTapped)
        })
        button.setTitle("Tap", for: .normal)
        button.translatesAutoresizingMaskIntoConstraints = false
        view.addSubview(button)
        NSLayoutConstraint.activate([
            button.centerXAnchor.constraint(equalTo: view.centerXAnchor),
            button.centerYAnchor.constraint(equalTo: view.centerYAnchor)
        ])
        
        // 不再需要 observe 闭包
        present(item: $store.scope(state: \.confirmationDialog, action: \.confirmationDialog)) { store in
            UIAlertController(store: store)
        }
    }
}

技术背景

TCA 框架中的 UIBindable 属性包装器是专门为简化 UIKit 与 SwiftUI 之间的状态绑定而设计的。它会自动处理状态变化和视图更新，开发者不需要手动监听状态变化。当我们将 present 方法放在 observe 闭包中时，实际上创建了一个不必要的双重绑定，这会导致状态更新循环，从而引发对话框自动关闭的问题。

最佳实践

1. 在 TCA 项目中，优先使用 UIBindable 来处理 UIKit 视图控制器的展示逻辑
2. 避免在 observe 闭包中嵌套其他状态绑定操作
3. 对于简单的对话框展示，直接使用 present 方法即可
4. 复杂的界面导航逻辑可以考虑使用 TCA 的路由功能

总结

这个问题很好地展示了 TCA 框架在 UIKit 环境中的使用注意事项。随着框架的不断更新，一些旧的模式可能不再适用。开发者需要及时了解框架的最新特性，并调整自己的编码习惯。在这个案例中，UIBindable 的引入简化了状态绑定的流程，但也要求开发者放弃一些传统的做法。理解这些变化背后的设计理念，能够帮助我们写出更简洁、更健壮的代码。