2010-07-08 29 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> 
相關問題