使用Maven Javadoc插件，我可以只为特定的包创建Javadoc吗？

Question

使用Maven JavaDoc插件，我可以只为特定的包创建JavaDoc吗？我有一个父模块，只想为子模块中选定的包生成Javadoc。例如

Parent
|
|__Module1
|____Package1
|____Package2
|
|__Module2
|____Package3
|____Package4

我希望Javadocs只适用于Module1下的Package2

Answer 1

在父文件中定义javadoc插件。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.0.0-M1</version>
    <configuration>
        <skip>true</skip>
    </configuration>
</plugin>

因此，javadoc生成是可用的，但默认情况下会被跳过。

在模块1中，用skip和sourceFileIncludes声明插件。例如：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <configuration>
        <skip>false</skip>
        <sourceFileIncludes>
            <exclude>Package2/*.java</exclude>
        </sourceFileIncludes>
    </configuration>
</plugin>

这为module1启用javadoc生成，但仅针对Package2中的类。

这通过Maven Javadoc插件的v3.0.0-M1进行了验证。