使用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
• 创建一个罐子是罐子连接到构建using the buildhelper plugin

在重新阅读的问题：我假设你要创建的文档合并所有依赖关系。如果没有，你需要40个独立的执行每个javadoc，assembly和buildhelper插件。祝你好运。

Answer 2

比上面的回答稍微自动化的方法：

因此，为了使这项工作，你就必须做到这一切：

• ，因为这是一个专门的javadoc的神器，它赢得了”吨有一个主要的JAR构件，所以你可能会想设置的包装POM
• 确保您的所有引用的文物有attached sources
• 添加<classifier>sources</classifier>所有的依赖
• 解开所有依赖于一个共同的根文件夹使用dependency:unpack-dependencies
• 改变你的源代码目录是你解开所有的依赖
• 使用源插件来管理所有的Javadoc生成和部署