2010-07-27 112 views
5

我想在Eclipse中爲我的Android項目生成Javadoc html頁面。我試圖使用-linkoffline參數,作爲suggested here,以及使用指向我的android.jar文件的-classpath參數。這些都沒有工作,因爲我仍然得到package android.app does not exist(和其他)警告。我也嘗試從命令行運行javadoc工具,而不是使用Eclipse。Android上的Javadoc(Eclipse)

理想情況下,我想爲自己的類生成自己的頁面,並將所有android。*和java。*類鏈接到在線頁面。我正在使用Java版本1.6.0_20的Mac OS 10.6。

回答

1

您是否嘗試過使用javadocs的ant腳本?將它命名爲javadoc.xmlbuild.xml以外的東西 - 否則eclipse將選擇它作爲默認構建腳本。從eclipse(RMB on file | Run As | Ant Build)中或從控制檯:ant -f <file-name.xml>運行ant腳本。

礦看起來類似這樣:

<project basedir="." default="doc" name="metagloss api docs"> 

    <property 
     name="android-sdk-docs" 
     value="/home/blackrax/opt/dev/android-sdk-linux_86/docs/reference"/> 

    <target name="doc" description="api docs - no piwik" depends="clean, delombok"> 
     <javadoc destdir="docs"> 
      <link offline="true" 
        href="http://d.android.com/reference" 
        packagelistLoc="${android-sdk-docs}" /> 
      <fileset dir="src" includes="**/*.java" /> 
     </javadoc> 
    </target> 

    <!-- more implementation, any remaining targets --> 
</project> 
+0

這是否解決'包android.app不存在'問題? – 2011-02-09 17:11:30

3

在嘗試解決類似的問題我自己,我發現一直是兩個要點:

  • 要包括機器人.jar您正在鏈接的文件在javadoc Ant任務的classpath屬性中。這意味着類似如下:

    <javadoc ... 
        classpath="some/local/library.jar; 
        C:/Android/platforms/android-8/android.jar; 
        D:/another/library.jar" ... > 
    
  • 要以在線的Android參考網址與Android參考包列表的本地副本匹配下添加的Javadoc任務鏈接子項目。這意味着類似如下:

    <javadoc ...> 
        <link offline="true" 
        href="http://developer.android.com/reference/" 
        packagelistloc="C:/Android/docs/reference" /> 
    </javadoc> 
    

這是足以讓我爲了顯示我的項目的Javadoc中的Android鏈接。

+0

這工作對我來說,但我仍然有「包com.mypackage.R不存在」的警告。 – bancer 2012-06-29 21:01:52

+0

對不起,沒有幫助。我目前沒有建立這樣的環境。 – superjos 2012-07-23 10:15:30

+0

@superjos你可以告訴我,我必須在哪裏寫這些行 – 5er 2014-01-01 23:06:53