如何为 MacOS 生成工作索引 Mojave 和 Catalina 帮助

Question

这是一个“回答你自己的问题”的贡献。

我一直在努力让锚NSHelpManager在 10.15上的系统中工作，以便能够使用该openHelpAnchor:inBook:方法打开给定的帮助页面。

Apple 帮助系统文档很旧，有一段时间没有更新。该hiutil男子页面给出提示，指出：

在 macOS Mojave 或更高版本中需要 Spotlight 帮助索引。

但是，单独使用这两种可用格式中的任何一种都不起作用。

所以我不得不通过浏览 Xcode 本身的帮助资源来进行逆向工程以找到解决方案。

Answer 1

诀窍是在文件夹中生成两个索引文件，每个格式一个.lproj：

hiutil -I corespotlight -Cf help.cshelpindex -a -s fr -l fr .
hiutil -I lsm -Cf help.helpindex -a -s fr -l fr .

然后，这是未记录的密钥，需要在帮助中添加一个条目info.plist：

<key>HPDBookCSIndexPath</key>
<string>help.cshelpindex</string>

与传统的记录HPDBookIndexPath条目一起。

等等。