如何为Mojave和Catalina上的MacOS Help生成工作索引

Question

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

我已经挣扎了一天，试图在10.15让锚点在NSHelpManager系统中工作，以便能够使用openHelpAnchor:inBook:方法打开给定的帮助页面。

帮助系统的苹果文档很旧，有一段时间没有更新。hiutil手册页给出提示，说明：

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

但是使用两种可用格式中的任何一种本身都不起作用。

因此，我不得不通过浏览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>

以及传统的文档化CCD_ 6条目。

等等。