如何在 Ant 的 javadoc 任务中链接第三方库答案

【问题标题】：How to link third party libraries in Ant's javadoc task如何在 Ant 的 javadoc 任务中链接第三方库
【发布时间】：2011-03-13 12:54:33
【问题描述】：

我有一个使用 jar 文件形式的第三方库的项目，我正在使用 Ant 构建项目 javadocs。使用 javadoc 任务时，我无法让 Ant 链接到第三方库 javadocs。

这里是 javadoc 任务：

<javadoc excludepackagenames="" access="private" destdir="javadoc" author="true" 
         version="true" use="true" windowtitle="title" useexternalfile="true">
  <fileset dir="." defaultexcludes="yes">
    <include name="*/src/com/**/*.java"/>
  </fileset>

  <link href="http://www.redhillconsulting.com.au/products/simian/javadoc/"/> 
  <link href="http://java.sun.com/j2se/1.5.0/docs/api/"/>
</javadoc>

任务的输出表明 simian 包不存在：

[javadoc] C:\development\java\tools\src\com\cname\DuplicateCodeIdentifier.java:15: package au.com.redhillconsulting.simian does not exist
[javadoc] import au.com.redhillconsulting.simian.Checker;
[javadoc]                                        ^

运行 ant 任务会正确创建所有指向 Sun 网站的链接，但不会正确创建指向 redhillconsulting 网站的链接。两个 URL 都指向一个包列表文件和适当的路径（与包列表内容匹配）。

如何配置<javadoc> Ant 任务生成第三方站点的链接？

注意：simian jar 文件位于 tools/lib 中。我还没有看到它指定任何类型的类路径是一个选项，所以我没有探索那个途径，但我已经尝试将 jar 文件添加到文件集包含路径，但这没有任何好处。 p>

【问题讨论】：

一个非 Ant 特定的类似问题：stackoverflow.com/questions/17580248/…

标签： java ant javadoc

【解决方案1】：

javadoc 标签接受嵌入的classpath 标签

<javadoc ...>
    <classpath>
        <fileset dir="${dir.lib}">
            <include name="simian.jar"/>
        </fileset>
    </classpath>
</javadoc>

【讨论】：

【解决方案2】：

对于 *java 文件，由于某种原因这不起作用。我设法用 filesets 解决了这个问题，其中一个包括我当前的项目文件，另一个包括附加的包文件。我只是没有使用 sourcepath 属性。随意添加更多文件很容易。但是，我没有尝试 *jar 文件。

<target name="doc" depends="init" description="generate documentation">
  <javadoc 
       destdir="${doc.dir}"
       access="private"
       author="yes"
       linksource="yes">
    <fileset dir="./MyProject" includes="**/*.java" />        
    <fileset dir="./GuiPackage" includes="**/*.java" />        
  </javadoc>
</target>

【讨论】：