Android 上的 Javadoc (Eclipse)

Question

我正尝试在 Eclipse 中为我的 Android 项目生成 Javadoc html 页面。我尝试使用 -linkoffline 参数，如 suggested here ，以及使用指向我的 android.jar 文件的 -classpath 参数。这些都不起作用，因为我仍然收到 package android.app does not exist (和其他)警告。我还尝试从命令行运行 javadoc 工具，而不是使用 Eclipse。

理想情况下，我希望自己为我的类(class)生成页面，所有 android.* 和 java.* 类(class)都链接到在线页面。我使用的是 Mac OS 10.6 和 Java 版本 1.6.0_20。

Answer 1

在尝试自己解决类似问题时，我发现了两个要点:

• 要将您要链接到的 android.jar 文件包含在 javadoc Ant 任务的类路径属性中。这意味着类似于以下内容:

  <javadoc ... 
    classpath="some/local/library.jar;
      C:/Android/platforms/android-8/android.jar;
      D:/another/library.jar" ... >
  

• 在 javadoc 任务下添加一个 link 子项，以便将在线 Android 引用 URL 与 Android 引用 package-list 的本地副本相匹配。这意味着类似于以下内容:

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

这足以让我在我的项目 Javadoc 中显示 Android 链接。