0

我有一个关于 Apache Maven 中的 Maven javadoc 插件的问题。如果安装阶段将被执行，我当前的配置允许为我的 Maven 项目创建一个完整的新 Java 文档。如果我调用命令“mvn clean install”，java doc 文件将被完全删除（为此，我自定义了 Maven clean 插件）。并且在安装阶段，java doc 文件将再次生成！

有没有办法以这种方式自定义 java doc 插件，只有更改的 java 源代码部分才会在现有的 java doc 中更新？并且不会再次生成完整的java doc？

我的 maven-javadoc-配置：

<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>
4

1 回答 1

0

也许 JavaDoc 不能在快照构建中生成 - 取决于您的要求。如果是这样，请为发布或特殊构建添加配置文件，其中包括 maven-javadoc-plugin 配置，并从默认构建/插件部分中删除插件。当您想要生成 JavaDoc 时，使用“mvn clean install -P <profile>”运行配置文件。否则只需运行“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”

于 2015-01-12T07:36:10.983 回答