2010-07-08 31 views
7

我有一个项目,它以jar文件的形式使用第三方库,并使用Ant构建项目javadoc。在使用javadoc任务时,我无法将Ant链接到第三方库javadoc。如何在Ant的javadoc任务中链接第三方库

这里是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> 

从任务的输出说,猴包不存在:

[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网站正确的,但不是红山咨询网站。这两个URL都会生成一个包列表文件和适当的路径(与包列表内容匹配)。

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

注意:sim jar jar文件位于tools/lib中。我没有看到它指定任何类路径是一个选项,所以我没有探索该途径,但我已经尝试将jar文件添加到文件集包含路径,这并不是什么好事。

+0

一个非蚂蚁特定的类似问题:http://stackoverflow.com/questions/17580248/javadocs-link-to-external-javadoc – 2015-03-30 08:15:49

回答

13

javadoc标记接受嵌入式classpath标签

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

对于* java的文件,这并没有出于某种原因。我管理与文件集解决这个问题,其中之一包括我当前的项目文件,另一个包括额外的软件包文件。我根本没有使用源路径属性。很容易随意添加更多文件。但是,我没有尝试* 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> 
相关问题