将外部文档(从 xyz-javadoc.jar)复制到 JavaDocs

Copy external docs (from xyz-javadoc.jar) into JavaDocs

我想用 Ant 创建一个 .jar 文件,其中包含我的库及其依赖项的所有 JavaDoc。我昨天 afternoon/evening 和今天早上进行了大量搜索,但 none 的解决方案对我有用。

我的第一个解决方案:

<!-- Generate JavaDoc -->
<javadoc sourcepath="${src}" destdir="${doc}" windowtitle="${ant.project.name}">
   <classpath path="${lib}/nv-websocket-client-2.9-javadoc.jar"/>
   <classpath path="${lib}/gson-2.8.6-javadoc.jar"/>
</javadoc>

我的第二个解决方案:

<!-- Generate JavaDoc -->
<javadoc sourcepath="${src}" destdir="${doc}">
   <classpath>
      <fileset dir="${lib}">
         <include name="gson-2.8.6-javadoc.jar"/>
         <include name="nv-websocket-client-2.9-javadoc.jar"/>
      </fileset>
   </classpath>
</javadoc>

然而,在这两种情况下,都只生成了我自己的代码的 JavaDoc。库被完全忽略。在 Ant-Task 的日志中有错误,找不到库中的 类。

我不知道这是否是最好的方法,但对我来说,从命令行使用“jar”更容易。

然后您所要做的就是指出您的文件所在的位置:

jar uf0 path_to_your_jar\your_jar_file.jar path_to_your_files\*.*
jar uf0 path_to_your_jar\your_jar_file.jar path_to_your_other_files\*.*

如果你要添加的库已经打包成jar文件,我会先解压到根目录下,这样每个文件的路径都是正确的。如果执行前面的命令,您将在“your_jar_file.jar”文件中拥有所有文件。

如果您从命令行键入 jar --help,您将看到更多选项。希望对你有帮助。