我有一个大项目,其中有一个父级,外加多个子模块。我希望在生成Javadoc时将其包含在测试类中。 (我从来不关心我在团队之外所做的任何事情都分发Javadoc。)该项目中有一些测试实用程序;例如:与必须打开其源代码并挖掘信息相比,访问Javadoc是一个有用的捷径。
在命令行上使用它...
mvn clean install javadoc:javadoc javadoc:aggregate
(是的,我曾尝试在命令行中添加javadoc:test-javadoc
或javadoc:test-aggregate
,但没有任何效果)
......我已经在根 pom.xml 中使用以下配置为生产类生成Javadoc(子子模块 pom.xml <中不需要任何内容) / em>文件):
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>3.2.0</version>
<configuration>
<noqualifier>all</noqualifier>
<destDir>javadoc</destDir>
<show>private</show>
</configuration>
<executions>
<execution>
<id>aggregate</id>
<goals>
<goal>aggregate</goal>
</goals>
<configuration>
<reportOutputDirectory>${user.dir}</reportOutputDirectory>
<destDir>javadoc</destDir>
</configuration>
</execution>
</executions>
</plugin>
这会将Javadoc放在文件 file:///home/russ/.../target/site/apidocs/javadoc/index.html 的路径中,可在浏览器中轻松查看它