MacOS Cocoa Swift应用自定义Help Menu不显示问题求助

问题根源 #

AppKit的标准Help菜单依赖Info.plist中的帮助相关配置，即使暂时没有本地帮助文件，也需要先配置对应键值，系统才会在主菜单中预留Help菜单的位置，否则直接通过app.helpMenu = helpMenu赋值不会生效。

解决步骤 #

1. 配置Info.plist
   添加以下两个键（值可先填占位符，后续添加帮助文件时再完善）：

   • CFBundleHelpBookName：设为应用名称（如$(PRODUCT_NAME)）或自定义名称
   • CFBundleHelpBookFolder：设为Help或空字符串

2. 编写自定义Help菜单代码
   在AppDelegate的applicationDidFinishLaunching方法中创建并配置Help菜单，确保菜单项的target和action正确绑定：

import Cocoa

@main
class AppDelegate: NSObject, NSApplicationDelegate {

    func applicationDidFinishLaunching(_ aNotification: Notification) {
        // 创建自定义Help菜单
        let helpMenu = NSMenu(title: "Help")
        
        // 在线帮助菜单项
        let onlineHelpItem = NSMenuItem(title: "在线帮助", action: #selector(openOnlineHelp(_:)), keyEquivalent: "")
        onlineHelpItem.target = self
        helpMenu.addItem(onlineHelpItem)
        
        // 添加分隔符
        helpMenu.addItem(NSMenuItem.separator())
        
        // 导航快捷键菜单项
        let shortcutsItem = NSMenuItem(title: "导航快捷键", action: #selector(showShortcuts(_:)), keyEquivalent: "")
        shortcutsItem.target = self
        helpMenu.addItem(shortcutsItem)
        
        // 绑定到应用的helpMenu
        NSApplication.shared.helpMenu = helpMenu
    }
    
    @objc private func openOnlineHelp(_ sender: NSMenuItem) {
        guard let url = URL(string: "https://your-help-site.com") else { return }
        NSWorkspace.shared.open(url)
    }
    
    @objc private func showShortcuts(_ sender: NSMenuItem) {
        // 实现快捷键列表展示逻辑，示例用NSAlert弹出
        let alert = NSAlert()
        alert.messageText = "导航快捷键"
        alert.informativeText = """
        ⌘ + N: 新建文档
        ⌘ + O: 打开文档
        ⌘ + S: 保存文档
        ⌥ + ⌘ + R: 刷新内容
        """
        alert.runModal()
    }
}

后续扩展支持本地帮助文件 #

当需要添加本地.helpbook帮助文件时，只需：

• 将帮助文件添加到项目中
• 更新CFBundleHelpBookName为帮助书的实际名称，CFBundleHelpBookFolder为帮助文件所在路径
• 系统会自动将标准的"打开帮助"菜单项添加到你的自定义Help菜单中，无需修改现有代码，完全兼容之前的自定义逻辑

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