如何自定義maven-java-doc插件，即只有已更改的Java源代碼部分將在完整的生成的Java docfile中更新？

Question

我有一個關於Apache Maven中的Maven javadoc插件的問題。 我的當前配置允許創建Maven項目的全新Java文檔（如果將執行安裝階段）。 如果我將命令稱為“ mvn clean install”，則將完全刪除java doc文件（為此，我已自定義Maven clean插件）。 在安裝階段，將再次生成Java doc文件！

有沒有辦法以這種方式自定義java doc插件，即僅在現有的Java doc中更新已更改的Java源代碼部分？ 並且不會再次生成完整的Java文檔嗎？

我的Maven-javadoc-configuration：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <configuration>
        <noqualifier>all</noqualifier>
        <reportOutputDirectory>myJavaDocOutputDirectory</reportOutputDirectory>
    </configuration>
    <executions>
        <execution>
            <id>create-myjavadoc</id>
            <phase>install</phase>
            <goals>
                <goal>javadoc</goal>
            </goals>
        </execution>
    </executions>
</plugin>

我的maven-clean-plugin配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-clean-plugin</artifactId>
    <version>2.4.1</version>
    <configuration>
        <filesets>
            <fileset>
                <directory>target</directory>
                <includes>
                    <include>**/*</include>
                </includes>
                <followSymlinks>false</followSymlinks>
            </fileset>
            <fileset>
                <directory>MySourcefolder</directory>
                <includes>
                    <include>**/*</include>
                </includes>
                <followSymlinks>false</followSymlinks>
            </fileset>
        </filesets>
    </configuration>
</plugin>

Answer 1

也許不能在快照版本中生成JavaDoc-取決於您的要求。 如果是這樣，請添加用於發行或特殊構建的配置文件，其中包括maven-javadoc-plugin配置，然后從默認的“構建/插件”部分中刪除該插件。 當您要生成JavaDoc時，請使用“ mvn clean install -P <配置文件>”運行配置文件。 否則，請運行“ mvn clean install”以避免生成JavaDoc。 這樣的配置文件可以如下所示：

<profiles>
  <profile>
    <id>release-build</id>

    <build>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-javadoc-plugin</artifactId>
          <version>2.9</version>
          <configuration>
            <noqualifier>all</noqualifier>
            <reportOutputDirectory>myJavaDocOutputDirectory</reportOutputDirectory>
          </configuration>
          <executions>
            <execution>
              <id>create-myjavadoc</id>
              <phase>install</phase>
              <goals>
                <goal>javadoc</goal>
              </goals>
            </execution>
          </executions>
        </plugin>
      </plugins>
    </build>
  </profile>
</profiles>

您可以使用以下命令運行它：“ mvn clean install -P release-build”