如何在SwiftUI macOS DocumentGroup应用中关联帮助菜单与应用逻辑？

在SwiftUI的DocumentGroup应用中，默认Help菜单下的「MyApp Help」点击后会显示「Help isn't available for MyApp」，若要修改该菜单项的逻辑但不想替换整个Help菜单，可通过以下两种方式实现：

方式一：通过SwiftUI CommandGroup替换并保留系统菜单 #

直接替换整个Help菜单组，同时保留系统默认的其他Help子项，自定义目标菜单项的行为：

import SwiftUI

@main
struct MyApp: App {
    var body: some Scene {
        DocumentGroup(newDocument: { MyDocument() }) { configuration in
            ContentView()
        }
        .commands {
            CommandGroup(replacing: .help) {
                // 自定义"MyApp Help"菜单项逻辑
                Button("MyApp Help") {
                    // 示例：打开自定义帮助网页
                    if let helpURL = URL(string: "https://your-help-resource.com") {
                        NSWorkspace.shared.open(helpURL)
                    }
                }
                // 分隔线
                Divider()
                // 保留系统默认的Help子项（如搜索帮助等）
                CommandGroup(after: .help) {}
            }
        }
    }
}

方式二：借助AppKit修改现有菜单 #

通过遍历应用菜单结构，直接找到目标菜单项并替换其动作，无需替换整个Help菜单：

import SwiftUI

@main
struct MyApp: App {
    init() {
        setupCustomHelpAction()
    }
    
    var body: some Scene {
        DocumentGroup(newDocument: { MyDocument() }) { configuration in
            ContentView()
        }
    }
    
    private func setupCustomHelpAction() {
        guard let mainMenu = NSApplication.shared.mainMenu,
              let helpSubmenu = mainMenu.item(withTitle: "Help")?.submenu else {
            return
        }
        
        // 匹配应用帮助菜单项标题（适配本地化名称）
        let appHelpTitle = "\(Bundle.main.displayName ?? "MyApp") Help"
        for menuItem in helpSubmenu.items where menuItem.title == appHelpTitle {
            menuItem.action = #selector(openCustomHelp(_:))
            menuItem.target = self
            break
        }
    }
    
    @objc private func openCustomHelp(_ sender: NSMenuItem) {
        // 示例：打开本地Help Book（需先配置Info.plist）
        // NSHelpManager.shared.openHelpAnchor(nil, inBook: "com.yourcompany.MyApp.help")
        // 或打开网页
        if let helpURL = URL(string: "https://your-help-resource.com") {
            NSWorkspace.shared.open(helpURL)
        }
    }
}

extension Bundle {
    // 获取应用显示名称（适配本地化）
    var displayName: String? {
        object(forInfoDictionaryKey: "CFBundleDisplayName") as? String ??
        object(forInfoDictionaryKey: "CFBundleName") as? String
    }
}

注意事项 #

• 若使用本地Help Book（.helpbook格式），需在Info.plist中配置CFBundleHelpBookName和CFBundleHelpBookFolder等键，确保系统能识别帮助资源。
• 方式二中的菜单标题匹配需考虑本地化，使用Bundle的displayName可避免因系统语言变化导致匹配失败。

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