Jenkins中的Doxygen插件：OUTPUT_DIRECTORY错误

Question

我的应用程序的根目录是Doxyfile所在的位置： /home/aaa/public_html

我想在以下位置生成文档： /home/bbb/public_html/ccc

效果不错但不适用于Jenkins：我收到错误hudson.AbortException: The output directory doesn't exist.

我的Jenkins工作的工作区是： /var/lib/jenkins/jobs/Doxy1/workspace

我努力但却行不通。我该怎么办？

Answer 1

我找到了解决方案。

我没有使用插件，而是使用Doxygen生成命令在Jenkins中创建了自由式作业。

Answer 2

我发现错误hudson.AbortException: The output directory doesn't exist是指Doxygen配置文件中的OUTPUT_DIRECTORY变量。

你必须在Doxygen插件中考虑三件事（至少从0.15开始）。

在Jenkins任务的Doxygen插件配置中：

• Doxyfile路径：此路径必须与Jenkins任务工作区相对。并指向包含Doxygen配置的.doxy文件。
• 运行doxygen的文件夹：Jenkins任务工作区内的文件夹。

在Doxygen配置文件中：

• OUTPUT_DIRECTORY变量：此变量设置我们要生成Doxygen输出的目录。它可以是相对的或绝对的。如果它是相对的，它将相对于运行Doxygen的文件夹。如果我们想将Doxygen输出保留在运行Doxygen的同一文件夹中，我们应该将此OUTPUT_DIRECTORY变量留空。

Answer 3

从版本0.16开始，Doxygen插件提供了生成文档的构建步骤。

请参阅https://wiki.jenkins-ci.org/display/JENKINS/Doxygen+Plugin

Answer 4

如果publish doxygen构建步骤doxyfile path字段包含额外的空格，我发现我收到此错误。确保您的doxyfile路径没有任何尾随空格或其他空格字符。我的doxygen插件版本是0.18。