用maven创建Javadoc

Question

我们已经创建了一个新工件来生成javadoc。我们将40个工件定义为依赖项。任务是为40个依赖项工件创建javadoc.jar和html页面。

什么是在maven中实现这一目标的最佳方法？

Answer 1

这很不寻常。 Javadoc适用于源代码，而不是编译类，而maven依赖项引用类，而不是源代码。

所以为了完成这项工作，你必须做所有这些：

• 因为这是一个专用的javadoc工件，它不会有主JAR工件，所以你可能想要将包装设置为POM
• 确保所有引用的工件都有attached sources
• 将<classifier>sources</classifier>添加到所有依赖项
• 使用dependency:unpack-dependencies
将所有依赖项解压缩到公共根文件夹 该文件夹
• run javadoc
• 使用maven-assembly-plugin
创建一个jar
• 将该jar附加到构建using the buildhelper plugin

重新阅读问题：我假设您要创建所有依赖项的组合文档。如果没有，您将需要40个单独的执行javadoc，assembly和buildhelper插件。祝你好运。

Answer 2

比上面的答案略微更自动化的方法：

所以为了完成这项工作，你必须做所有这些：

• 因为这是一个专用的javadoc工件，它不会有主JAR工件，所以你可能想要将包装设置为POM
• 确保所有引用的工件都有attached sources
• 将<classifier>sources</classifier>添加到所有依赖项
• 使用dependency:unpack-dependencies
将所有依赖项解压缩到公共根文件夹
• 将您的sources目录更改为解压缩所有依赖项的位置
• 使用源插件管理所有Javadoc生成和部署