Mac Catalyst应用中canPerformAction需进后台才触发，返回后工具栏项失效

问题场景 #

你的Mac Catalyst应用采用UISplitViewController层级结构（侧边栏→列表VC→详情VC），按官方教程配置了target = nil的NSToolbarItem，并在详情VC中通过canPerformAction控制按钮启用状态，但遇到以下异常：

• canPerformAction仅在应用退出前台时被调用
• 切回应用后该方法不再触发，工具栏项自动变为禁用状态

解决方案 #

1. 手动触发UI项状态验证

Catalyst在部分场景下不会自动更新工具栏按钮的状态，你可以在需要刷新状态的时机（比如详情VC视图出现、选中内容变化时）主动让系统重新验证：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    // 触发全局UI项状态校验
    NSApp.sendAction(#selector(NSValidation.validateUserInterfaceItem(_:)), to: nil, from: self)
}

// 若有选中项变化的方法，也添加该触发逻辑
func didSelectTargetItem(_ item: YourItemModel) {
    // 更新详情内容后调用
    NSApp.sendAction(#selector(NSValidation.validateUserInterfaceItem(_:)), to: nil, from: self)
}

2. 显式设置ToolbarItem的Target

避免依赖target = nil的隐式响应链查找，直接将ToolbarItem的target绑定到详情VC实例（配置Toolbar时可通过SplitViewController获取详情VC引用）：

// 配置ToolbarItem时的修改
if let detailVC = splitViewController.viewControllers.last as? DetailVC {
    item.target = detailVC
}

这种方式能让系统精准定位响应对象，减少状态更新失效的概率。

3. 改用UICommand验证机制

替代旧的canPerformAction，采用苹果推荐的UICommand方式管理工具栏项状态，适配性更强：
首先在详情VC中定义UICommand：

@objc func editSelectedItem(_ sender: Any?) {
    // 你的编辑逻辑
}

lazy var editCommand: UICommand = {
    UICommand(
        title: "Edit Item",
        image: UIImage(systemName: "square.and.pencil"),
        action: #selector(editSelectedItem(_:)),
        propertyList: nil
    )
}()

然后在Toolbar配置时关联该command：

let item = NSToolbarItem(itemIdentifier: itemIdentifier)
item.command = editCommand
return item

最后实现validate(_:)方法控制启用状态：

override func validate(_ command: UICommand) {
    if command == editCommand {
        // 可根据实际条件（如是否有选中项）动态设置
        command.isEnabled = true
    }
    super.validate(command)
}

原因说明 #

该问题核心是Catalyst应用前后台切换后，响应链未自动触发工具栏项的状态重新校验，上述三种方法分别从手动触发、精准绑定、API升级三个角度解决了这个问题。

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