使用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生成和部署