如何为Android兼容包安装javadoc？

时间：2011-12-20 14:45:29

标签： android javadoc

如何为Android 1.4兼容包生成自定义javadoc？

参考文档可在线获取（example），但在某些地方我可以使用javadoc脱机获取拉链？

我认为使用javadoc非常简单，只需设置兼容jar的javadoc位置即可。

6 个答案:

答案 0 :(得分：28)

您可以从源代码中自行离线生成javadoc。只需导航到您的android sdk目录，然后执行以下操作

cd <path_to_android_sdk>/extras/android/compatibility/v4/
mkdir docs

对于Windows：

javadoc -d docs -sourcepath src\java -subpackages android.support.v4

对于Linux / Mac：

javadoc -d docs -sourcepath src/java -subpackages android.support.v4

这将在您刚刚创建的docs目录中为您生成javadoc。

然后在你的eclipse android项目中，转到你添加了android-support-v4.jar的项目属性，编辑它的属性并添加你刚创建的javadocs的路径。

这应该有用！

ADT 17+问题：

正如你们中的一些人所指出的那样。让Eclipse看到ADT 17+附带的javadoc一直存在问题。这是一个已知问题，已提交错误。这与生成javadoc的方式无关（如上所述），而这是ADT 17+与Eclipse集成的问题。有人描述了一种解决方法，可以在此处遵循：

http://code.google.com/p/android/issues/detail?id=28801

答案 1 :(得分：12)

问题：如果android-support-v4.jar位于/libs文件夹中（因为ADT 17+要求），则javadoc不可用。

编辑：我通过将android javadoc的离线版本链接到android-support-v4.jar来解决这个问题。据我所知，仍然无法链接在线版本（http://developer.android.com/reference）。步骤进行：

  1. 从SDK Manager下载Android SDK文档。您可以在最新的Android版本（4.1）
    2. 下找到它
  2. 将javadoc文件夹链接到项目的文件夹，在Windows中打开控制台并键入：MKLINK /J {PROJECT_PATH}\android_docs {SDK_PATH}\docs\reference

  3. 使用以下内容创建文件libs/android-support-v4.jar.properties：

    src=android-support-v4.jar
doc=../android_docs

  4. 关闭项目并重新打开它。必要时进行清洁。

  5. javadoc是链接的。通过访问任何支持库类来检查它，如android.support.v4.app.FragmentActivity

    6. 感谢您的回答https://stackoverflow.com/a/11579339/933261

答案 2 :(得分：2)

@wnafee的答案很明显，但如果您使用的是Linux，请不要忘记在src/java这个位置使用正斜杠字符。

答案 3 :(得分：2)

如果你在WINDOWS并且像我一样长时间陷入困境，请确保你在属性文件中逃避你的后退，否则事情会无声地失败。 （无论如何，谁使沉默失败的装载机......）

这是我的属性文件：

src=android-support-v4.jar
doc=doc\\android-support-v4_doc

我的导演看起来像这样：

android-support-v4.docs.zip
android-support-v4.jar
android-support-v4.jar.properties
doc

关闭项目并打开，这一切都适合我。

答案 4 :(得分：1)

我根据wnafee的答案生成了这个： https://dl.dropboxusercontent.com/u/31272696/android-support-v4.zip

答案 5 :(得分：0)

我经历了所有这些解决方案，但没有一个能够奏效。以下是我为使其发挥作用所做的工作：

  1. 导航到以下文件夹： d：\\ Android的SDK \ Android的SDK窗口\额外\机器人\支持\ V4

  2. 运行命令： javadoc -d docs -sourcepath src \ java -subpackages android.support.v4

  3. 在项目的libs目录中，创建一个名为android-support-v4.jar.properties的文件

  4. 在属性文件中，添加以下行（更改路径以匹配您的路径）：

    doc = D：\ Program Files \ Android-SDK \ android-sdk-windows \ extras \ android \ support \ v4 \ docs src = D：\ Program Files \ Android-SDK \ android-sdk-windows \ extras \ android \ support \ v4 \ src

  5. 在Eclipse中，打开Build的属性对话框，然后导航到Java Build Path并选择Libraries选项卡。

  6. 展开支持库。在我的情况下，路径是： D：\ Program Files \ Android-SDK \ android-sdk-windows \ extras \ android \ support \ v4

  7. 选择Javadoc位置。单击“编辑”按钮，然后选择文档的路径。在我的情况下它是： file：/ D：/ Program Files / Android-SDK / android-sdk-windows / extras / android / support / v4 / docs /

  8. 关闭所有内容，包括Eclipse并重新启动。您现在应该可以在代码中浏览文档。

相关问题
最新问题