ant - 如何让 javadoc 使用 Ant 任务链接到 Java API？

Question

现在我的蚂蚁任务看起来像。

<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？我在代理后面。

Answer 1

您还可以在 ant 任务中传递参数

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

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

Answer 2

您可能需要设置http.proxyHost 和 http.proxyPort 系统属性。例如，ANT_OPTS="-Dhttp.proxyHost=proxy.y.com" ant doc

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

Answer 3

You can also use the "offline" mode that allows you to build (faster!) without accessing the internet. Please see this answer: https://stackoverflow.com/a/24089805/366749