我最近设置了构建服务器 (Jenkins) 来为 Ant 构建生成 Javadoc。但是,无论我做什么,我都无法让它包含指向外部库的链接。当我尝试使用在线链接时,Ant 返回:
[javadoc] javadoc: warning - Error fetching URL: http://docs.oracle.com/javase/6/docs/api/package-list
当我使用离线链接并引用包列表的本地副本时,它没有给出任何警告,但也不生成链接。我尝试链接的每个库都会出现这种情况,而不仅仅是 Java SE。以下是我的 build.xml 中链接的相应行:
<link offline="true" href="http://docs.oracle.com/javase/6/docs/api/" packagelistLoc="javadoc/javase6/package-list" />
和:
<link href="http://docs.oracle.com/javase/6/docs/api/" />
值得一提的是,服务器的互联网连接没有特别不寻常的配置。经过一些研究,我发现我收到的警告在使用代理时很常见,但我找不到任何在直接连接的服务器上返回的情况。
我还想提一下,我已经验证我的离线包列表位于正确的位置,并且可以通过构建文件的相对路径访问。
编辑 #1:这显然也是 Maven 上的一个问题,表明 Javadoc 工具本身已损坏。
编辑 #2:值得一提的是,我正在使用 JDK 1.6 update 45 进行编译。
最佳答案
<link offline="true" href="http://docs.oracle.com/javase/6/docs/api/"
packagelistLoc="javadoc/javase6/package-list" />
应该是:
<link offline="true" href="http://docs.oracle.com/javase/6/docs/api/"
packagelistLoc="javadoc/javase6/" />
packagelistLoc
是包含 package-list
文件的目录的路径。
关于java - Ant /马文 : "javadoc: warning - Error fetching URL",我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/22273529/