Плагин Maven Javadoc 3.1.0 не генерирует агрегированные Javadocs - PullRequest
Новая
       61

Плагин Maven Javadoc 3.1.0 не генерирует агрегированные Javadocs

0 голосов
/ 13 июня 2019

У меня есть многомодульный проект, для которого я хотел бы создавать сводные отчеты Javadoc. Я использую maven-javadoc-plugin версию 3.1.0. Вот раздел отчетов файла pom.xml: 

<reporting>
 <plugins>
  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.1.0</version>
    <reportSets>
      <reportSet>
        <id>non-aggregate</id>
        <reports>
          <report>javadoc</report>
        </reports>
      </reportSet>
      <reportSet>
        <id>aggregate</id>
        <inherited>false</inherited>
        <reports>
          <report>aggregate</report>
        </reports>
      </reportSet>
    </reportSets>
  </plugin>
 </plugins>
</reporting>

Я использую mvn site:site site:stage целей для создания отчетов Javadoc. Когда я запускаю эту команду, я ожидаю увидеть каталог apidocs, содержащий index.html в target/site/, но я не вижу каталог apidocs.

Что интересно, если я переключусь на 3.0.1 версию maven-javadoc-plugin, агрегатные javadocs будут успешно сгенерированы.

Я понимаю, что произошли изменения в том, как aggregate отчеты генерируются в 3.1.0, поскольку задокументировано здесь , и я использовал ту же настройку отчетности.

Кроме того, javadoc для отдельных модулей генерируются правильно для обеих версий плагина.

Другие детали:

  • JDK 8
  • maven-site-plugin версия 3.7.1
...