【发布时间】：2011-09-02 06:27:50
【问题描述】：
如何在 Xcode 4 中使用 Doxygen 构建文档集？
Apple 的文档引用了 Xcode 3，似乎不适用于 Xcode 4。
我认为它可能必须使用模式（模式？）而不是目标，但我不是 100% 确定。
提前谢谢...
【问题讨论】：
【发布时间】：2011-09-02 06:27:50
【问题描述】：
您可以将文档构建为专用目标的一部分：
- 在项目导航器中，单击项目。
- 在右侧窗格中，添加一个新的聚合目标（在 MacOSX/Other 中）并将其命名为 Documentation
- 在这个目标中，添加一个新的运行脚本构建阶段
- 在此构建阶段，调用 Doxygen 命令行：
/Applications/Doxygen.app/Contents/Resources/doxygen
- 构建 DocSet 后，将其复制到
/Users/<YourName>/Library/Developer/Shared/Documentation/DocSets文件夹中。 - 新的文档集应该出现在帮助浏览器中。
【讨论】：
Xcode 3 的文档似乎适用于 Xcode 4。 我按照说明进行操作（请参阅Using Doxygen to Create Xcode Documentation Sets on Documentation），一切都很好，摘录 Xcode 不会加载全新的文档集。
然后我检查了给定运行脚本上的 AppleScript 命令，并在 AppleScript 编辑器上对其进行了测试：执行结果为假。错误是缺少 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\""
【讨论】：
-
如果您创建用户构建设置 APPLICATION_IDENTIFIER 并将其设置为应用程序标识符，然后将 com.mycompany.DoxygenExample 替换为 ${APPLICATION_IDENTIFIER} 您还将获得一个更通用的脚本。 :)