Javadoc создание с Maven

Question

Мы создали новый артефакт для генерации Javadoc.У нас есть 40 артефактов, определенных как зависимости.Задача состоит в том, чтобы создать javadoc.jar и html-страницы для 40 артефактов зависимости.

Каков наилучший подход для достижения этого в maven?

Answer 1

Немного более автоматизированный подход, чем ответ выше:

Итак, чтобы сделать эту работу, вам нужно будет сделать все это:

• , поскольку это выделенный Javadoc-артефакт, у него не будет основного JAR-артефакта, поэтому вы, вероятно, захотите установить упаковку на POM
• убедитесь, что все ваши указанные артефакты имеют подключенных источников
• добавить <classifier>sources</classifier> ко всем вашим зависимостям
• распаковать все зависимости в общую корневую папку, используя dependency:unpack-dependencies
• Измените каталог исходных текстов, куда вы распаковали все зависимости
• Используйте плагин исходного кода для управления всеми процессами создания и развертывания Javadoc

Answer 2

Это очень необычно.Javadoc работает с источниками, а не скомпилированными классами, тогда как зависимости maven ссылаются на классы, а не на источники.

Поэтому, чтобы сделать эту работу, вам придется сделать все это:

• , так какявляется выделенным Javadoc-артефактом, у него не будет основного JAR-артефакта, поэтому вы, вероятно, захотите установить упаковку на POM
• , чтобы все ваши ссылочные артефакты имели подключенные источники
• добавьте <classifier>sources</classifier> ко всем вашим зависимостям
• распакуйте все зависимости в общую корневую папку, используя dependency:unpack-dependencies
• запустите javadoc в этой папке
• создайте банку с помощью maven-assembly-plugin
• прикрепите эту банку к сборке с помощью плагина buildhelper

Перечитав вопрос: я предполагаю, что вы хотите создать комбинированные документы всех зависимостей.Если нет, вам потребуется 40 отдельных исполнений для каждого из плагинов javadoc, assembly и buildhelper.Удачи с этим.