Как настроить плагин maven-java-doc, который изменил только разделы исходного кода Java, будет обновляться в полностью сгенерированных java docfiles?

Question

У меня есть вопрос относительно плагина Maven javadoc в Apache Maven. Моя текущая конфигурация позволяет создать полный новый java-документ моего проекта maven, если будет выполнен этап установки. Если я вызвал команду «mvn clean install», файлы doc java будут удалены полностью (для этого я настроил плагин Maven clean). И на этапе установки файлы java doc будут сгенерированы снова!

Есть ли способ настроить плагин java doc таким образом, чтобы только обновленные разделы исходного кода Java были обновлены в существующем java-документе? И не будет ли снова создан полный Java-документ?

Мой 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-чисто плагин:

<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 <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 чистую установку -P релиз-сборки»