Возникли проблемы с агрегацией maven-javadoc-plugin - PullRequest
3 голосов
/ 05 августа 2011

У меня агрегатный проект Maven с тремя дочерними модулями, поэтому проект выглядит так:

Родитель
|
| - ChildA
| - ChildB
| - ChildC

Классы используют агрегацию и наследование: родительский элемент перечисляет дочерних элементов как модули, а каждый дочерний элемент указывает родительского элемента в качестве родительского элемента. Каждый из детей вызывает maven-javadoc-plugin: jar для создания скульптурных javadoc с конкретными файлами, включенными в javadocs, что прекрасно работает.

Я хочу вызвать maven-javadoc-plugin: aggregate-jar в Parent pom, чтобы сгенерировать одну папку javadoc с комбинацией скульптурных javadoc для детей, но, похоже, она не работает. Если я запускаю javadoc: aggregate-jar в Project, похоже, что он агрегирует задачу до дочерних модулей, которые в любом случае выполняют свой собственный maven-javadoc-plugin, и тогда сам Project ничего не генерирует. Я попытался запустить несколько различных опций и использовать устаревший тег, но безрезультатно. Я также пытался создать четвертого потомка, зависящего от остальных трех, чтобы использовать опцию maven-javadoc-plugin, но, похоже, это не работает. Огорчает все то, что практически нет примеров использования агрегата на официальной странице плагина Maven или в Google, что наводит меня на мысль, что я просто делаю что-то не так.

Кто-нибудь когда-либо пытался сделать что-то подобное раньше и может предложить какую-нибудь помощь, как заставить это работать? Спасибо за любую помощь.

...