如何为使用 Mac Catalyst 移植到 Mac 的 iPad 应用程序设置“帮助”菜单选项？

Question

默认情况下，Mac Catalyst 创建一个标题为“帮助”的菜单，该菜单应该包含应用程序的帮助。但是，我没有找到有关如何实施帮助的文档。对于标准 Mac 应用程序，您可以使用帮助手册。但是，没有提及如何使用 Mac Catalyst 的帮助手册。我试图将 HelpBookDirectoryName 添加到 info.plist 但这不起作用。有没有办法让帮助书与 Mac Catalyst 一起使用？

Answer 1

我们为 iOS 应用程序使用基于 Web 的帮助系统，并将其添加到适当的 UIViewControllers 似乎可以连接 Catalyst 版本的帮助菜单命令：

    // Show some help.
@IBAction func showHelp(_ sender: Any) {
    UIApplication.shared.open(URL(string: "http://www.ourapp.com/faq")!)
}

// Return whether action can be performed.
override func canPerformAction(_ action: Selector, withSender sender: Any?) -> Bool {

    if action == #selector(self.showHelp(_:)) {
        return true
    } else {
        return super.canPerformAction(action, withSender: sender)
    }
}

Answer 2

好的...我设法通过使用第三方应用程序（Help Crafter）创建MyAppName.help文件/文件夹来使其工作，但您可以手动完成。

创建MyAppName.help文件后，您需要将其复制到项目中的Resources文件夹中。我首先将文件复制到 Finder 中的 Resources 文件夹，然后将该文件拖到 Xcode 中的 Resources 文件夹中。

最重要的一步：将其拖入项目时选择“创建文件夹引用”。

我之前选择了“创建组”，但从未奏效。

这个链接也有一些有用的信息，特别是如果你要手动创建 MyAppName.help 文件

http://swiftrien.blogspot.com/2015/06/adding-apple-help-to-os-x-application.html

简而言之，文件/文件夹中将包含一个.plist文件MyAppName.help，但您还需要向项目.plist文件中添加两个键：

• Help Book directory name->.help文件名（技术上是一个带有.help扩展名的目录）
• Help Book identifier-> 对我来说是，maccatalyst.com.nitramluap.MyAppName.help但它必须是MyAppName.help .plist密钥下的相同标识符Bundle Identifier