2010-07-27 117 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