java - JavaDoc 的备用输出目录

Question

我正在尝试为我的多模块 maven 项目中的 JavaDocs 配置一个备用输出位置。我将父 POM 中的 maven-javadoc 配置为如下所示:

<build>
...
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <configuration>
        <noqualifier>all</noqualifier>
        <reportOutputDirectory>
            ${project.reporting.outputDirectory}/api
        </reportOutputDirectory>
        <destDir>api</destDir>
    </configuration>
</plugin>
...
</build>

然后这里是我设置 project.reporting.outputDirectory 的地方。

<properties>
    <project.reporting.outputDirectory>
        ./module-webapp/src/main/webapp/docs
    </project.reporting.outputDirectory>
</properties>

但是，Maven 似乎并不关心上述配置，尽管如此，它还是在默认目录中输出 JavaDoc。为什么是这样？

另外，我为 project.reporting.outputDirectory 变量使用了相对路径。当我在子模块中运行 mvn javadoc:javadoc 和在父模块中运行它时，这个相对路径是否意味着同样的事情？

提前致谢...非常感谢!

Answer 1

您需要更改变量的名称。 project.reporting.outputDirectory 是一个内置变量，maven 会覆盖您对它的设置。

请注意，您可能仍需要设置相对于 project.reporting.outputDirectory 的目录，或类似 ${basedir} 的内容才能真正让它发挥作用。

另外请记住，根据我对文档的阅读，您的最终目录将是 ./module-webapp/src/main/webapp/docs/api/api，这可能不是正是你想要的

就相对目录和子模块而言，每个构建往往是独立的，因此它将存放与每个子构建相关的 javadoc。