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

Question

这是“您自己的问题的答案”贡献。

为了用NSHelpManager方法打开给定的帮助页面，我一直在努力使锚点在10.15的openHelpAnchor:inBook:系统中工作。

Apple帮助系统文档很旧，并且有一段时间没有更新。hiutil手册页提供了提示，指出：

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

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

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

Answer 1

诀窍是在two索引文件（每种格式一个）：

.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>
记录条目。

Etvoilà。