没有源代码构建JDocs

Question

我有一个人工服务器（ http://www.jfrog.com/open-source/ ），用于将某些第三方库部署到该服务器。 我有一个特定的第三方库，该库与包含该库的JDocs的doc目录一起提供。

我真的很想将doc目录编译成一个jar，以便我的团队可以将JDocs（以及第3方jar）从工件中拖出，而不必独立分发doc目录。 我搜索过的所有教程都建议您必须具有源文件才能执行此操作……显然，我没有。

我见过的Maven提示我需要源/项目。

我试过使用javadoc -d .\\docs -source .\\java\\classes\\library.jar -subpackage com.foobar但是很麻烦。

我曾尝试使用Eclipse将JDocs导出为聚合jar，但这是不可能的，或者我缺少一些符文。

Answer 1

假设您的第三方javdoc目录结构如下所示

3rd-party-doc/
   +- index.html
   +- index-all.html
   +- ...

您可以使用以下命令创建一个Javadoc jar

jar cvf 3rd-party-javadoc.jar -C 3rd-party-doc/ .

这将生成3rd-party-javadoc.jar ，其中包含您可以将其安装到本地maven存储库中的javadoc。

编辑以将生成的javadoc安装到本地Maven存储库中

mvn install:install-file -Dfile=3rd-party-javadoc.jar -DgroupId=com.example.3rd.party -DartifactId=3rd-party -Dversion=1.2.3 -Dpackaging=jar -Dclassifier=javadoc -DcreateChecksum=true

# -Dfile=3rd-party-javadoc.jar - the javadoc file you have generated
# -DgroupId=com.example.3rd.party - the maven group id of the 3rd party library (same as in repository/.../3rd-party-x.y.z.pom)
# -DartifactId=3rd-party - the maven artifact id of the 3rd party library (same as in repository/.../3rd-party-x.y.z.pom)
# -Dversion=1.2.3 - the 3rd party library version (same as in repository/.../3rd-party-x.y.z.pom)