如何让 javadoc 使用 Ant 任务链接到 Java API？答案

【问题标题】：How do I get javadoc to link to the Java API using an Ant task?如何让 javadoc 使用 Ant 任务链接到 Java API？
【发布时间】：2010-09-08 08:27:53
【问题描述】：

现在我的 ant 任务看起来像。

<javadoc sourcepath="${source}" destdir="${doc}">
    <link href="http://java.sun.com/j2se/1.5.0/docs/api/" />
</javadoc>

我收到了这个警告：

javadoc: warning - Error fetching URL: http://java.sun.com/j2se/1.5.0/docs/api/package-list

如何让 javadoc 正确链接到 API？我在代理后面。

【问题讨论】：

标签： ant javadoc

【解决方案1】：

你也可以在 ant 任务中传递参数

<arg value="-J-Dhttp.proxyHost=your.proxy.here"/>
<arg value="-J-Dhttp.proxyPort=##"/>

如果走离线链接路线。通过转到 Java API (http://java.sun.com/j2se/1.5.0/docs/api/package-list) 的 URL 下载包列表并将其保存为文本文件，然后使用此 Ant 任务。

<javadoc sourcepath="${source}" destdir="${doc}">
    <link offline="true" href="http://java.sun.com/j2se/1.5.0/docs/api/" packagelistloc="path-containing-package-list"/>
</javadoc>

【讨论】：

请注意，上面的path-containing-package-list 表示包含名为package-list 的文件的目录的路径。这不是package-list 文件本身的路径。

【解决方案2】：

您可能需要http.proxyHost and http.proxyPort system properties 集。例如ANT_OPTS="-Dhttp.proxyHost=proxy.y.com" ant doc

或者，您可以设置“离线”标志并提供包列表，但这对 Java 核心来说可能是个难题。

【讨论】：

【解决方案3】：

您还可以使用“离线”模式，无需访问互联网即可构建（更快！）。请看这个答案：https://stackoverflow.com/a/24089805/366749

【讨论】：