在Xcode 4中使用Doxygen构建文档集

Question

如何在Xcode 4中使用Doxygen构建文档集？

苹果的文档提到了Xcode 3，并不适用于Xcode 4。

我认为可能需要使用schemas（模式）而不是targets，但我并不完全确定。

提前感谢...

- Scott McKenzie

Answer 1

您可以作为专门目标的一部分构建文档：

• 在项目导航器中，单击项目。
• 在右窗格中，添加一个新的聚合目标（在MacOSX/其他中），并将其命名为 Documentation
• 在此目标中，添加一个新的 Run Script 构建阶段
• 在此构建阶段中，调用 Doxygen 命令行：

/Applications/Doxygen.app/Contents/Resources/doxygen

• 构建 DocSet 后，将其复制到 /Users/<YourName>/Library/Developer/Shared/Documentation/DocSets 文件夹中。
• 新的 docset 应出现在帮助浏览器中。

- Laurent Etiemble

Answer 2

看起来Xcode 3的文档可以与Xcode 4良好配合使用。 我按照说明（请参见在文档上使用Doxygen创建Xcode文档集）操作，一切都很好，但是Xcode无法加载全新的docset。

然后我检查了所给脚本中的AppleScript命令，并在AppleScript编辑器上进行了测试：执行结果为false。错误是缺少docset文件的名称。

通过添加docset文件名，AppleScript脚本成功运行，docset被正确插入到文档中：

之前：

echo "load documentation set with path \"/Users/$USER/Library/Developer/Shared/Documentation/DocSets/\""

之后：

echo "load documentation set with path \"/Users/$USER/Library/Developer/Shared/Documentation/DocSets/com.mycompany.DoxygenExample.docset\""

- Dominique Vial

---

如果您创建了一个名为APPLICATION_IDENTIFIER的用户构建设置，并将其设置为应用程序标识符，那么将com.mycompany.DoxygenExample替换为${APPLICATION_IDENTIFIER}，您还可以获得一个更通用的脚本。 :) - jkyle