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

Question

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

Apple 的文档引用了 Xcode 3，似乎不适用于 Xcode 4。

我认为它可能必须使用架构（schemata？）而不是目标，但我不能 100% 确定。

提前致谢...

Answer 1

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

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

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

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

Answer 2

Xcode 3 的文档似乎与 Xcode 4 配合得很好。
我按照说明进行操作（请参阅文档中的“使用 Doxygen 创建 Xcode 文档集”），一切都很好摘录 Xcode 不会加载全新的文档集。

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

通过添加文档集文件名，AppleScript 脚本成功运行，并且文档集已很好地插入到文档中：

之前：

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\""