如何为javadoc创建jar可分发文件？

Question

我已经创建了一个API，并将其作为JAR文件发布。它是专有的，所以我必须去掉它的源文件。

我目前包含了一个单独的/doc文件夹，其中包含Eclipse的export-to-javadoc向导的输出。还不错，但我还想再走一步。

我想将javadoc作为一个jar文件分发，它可以很容易地放到将来的项目中，其中包括我的API的jar文件。我知道在我使用过的其他发行版中，我已经看到过好几次这样做了，但是我没有找到任何幸运的搜索结果。

最终目标是让未来的开发人员能够轻松地将鼠标悬停在评论和类似的东西上。

谢谢!

Answer 1

将包含生成的文档的eclipse文档文件夹打包为jar文件似乎就足够了。然后，如果您希望将该jar用作包含已编译的.class文件的实际jar的javadoc，则在Eclipse中使用"Javadoc in archive"分配Javadoc jar，并将归档中的路径设置为文档。似乎Eclipse会在package-list文件夹中查找、index.html、和文档条目。

​

同样，使用maven-javadoc-plugin可能是一种简单的方法。请参阅以下链接：

http://www.avajava.com/tutorials/lessons/how-do-i-generate-and-deploy-a-javadoc-jar-file-for-my-project.html

Answer 2

如果您的最终目标只是希望将来的开发人员在使用您的类或方法时能够查看您的javadoc指令，那么在Eclipse中，您可以在导出jar库时选择导出java源文件，如下图所示：

​

​

这还允许开发人员在调试时介入并查看您的代码。