如何为Android支持库启用javadoc？

Question

当使用Android支持库进行兼容性处理并尝试查看例如FragmentTransaction的javadoc时，由于没有相关联的javadoc文件，会出现以下错误：

android.support.v4.app.FragmentTransaction

注意：此元素既没有附加的源代码也没有附加的Javadoc，因此找不到任何Javadoc。

支持库添加在项目属性中的“Android依赖项”下，并显示Javadoc位置：（无）-如下所示，不可修改。是否有任何解决方法？

- Jeff Axelrod

---

请问如何获取Android Support Library v4的源代码并将其附加到库中？ - Paul Verest

请查看我在此处的答案：https://dev59.com/hGoy5IYBdhLWcg3wcNvh#39567524 - M D P

Answer 1

我在“Android Dependencies”部分中使用了android-support-v4.jar，拼凑出了一个项目。我有一个类。

public class CountriesFragment extends ListFragment {...}

以及导入

import android.support.v4.app.ListFragment;

上面

我在libs文件夹中创建了一个名为android-support-v4.jar.properties的文件。它包含以下行：

doc=c:\\[path-to-android-sdk]\\docs\\reference
src=C:\\[path-to-android-sdk]\\extras\\android\\support\\v4\\src

如果不使用Windows，可能需要更改为未转义的斜杠。

接下来，右键单击项目，选择刷新，然后您将获得javadoc支持。您实际上不需要文档条目-- src条目已经包含了javadocs。

- NickT

---

这个答案是一个更好的参考：https://dev59.com/Q2kw5IYBdhLWcg3wdKbD - Jason Axelson

只需添加src行即可（特别是当doc行没有指向现有文件夹时）。此外，我会在文件夹C：\[path-to-android-sdk]\extras\android\support\v4中保留属性文件的副本。我不知道它是否会自动在新项目中被选中，但至少我有一个集中位置可以手动选择 :) - ADTC

此外，即使支持库位于“Android私有库”容器中，这也可以正常工作。您无需将其移动到“Android依赖项”容器中。 - ADTC

"项目 -> 关闭项目，项目 -> 打开项目" - leoly

如果您的支持库位于库项目中，则此文件（.properties）需要放在该库项目中，而不是您的工作项目中。 - Lukasz 'Severiaan' Grela

Answer 2

编辑： 请参考以下帖子：

如何将javadoc或源代码附加到libs文件夹中的jar包？

添加：

在Android SDK安装的\android-sdk\extras\android\support\v4目录下，您会找到android-support-v4.jar的源码（即src目录），您可以使用jar命令创建同样的jar文件。

希望它有所帮助:)

添加：

查看这个链接https://android-review.googlesource.com/#/c/35702/

根据此链接

在项目的libs目录中创建一个名为android-support-v4.jar.properties的文件，并将以下行添加到其中。

src: <相对或绝对路径到源文件夹（或存档）＞。

我尝试了这个解决方案并且对我有用。享受 :)

- Vishal Vyas

---

是的，除非支持库会在项目中重复出现，因为它已经在构建路径中如上面的屏幕截图所示。这似乎会成为一个问题。 - Jeff Axelrod

查看此链接：https://dev59.com/Q2kw5IYBdhLWcg3wdKbD。 - Vishal Vyas

谢谢。我会等一会儿看看是否有更优雅的解决方案出现。不幸的是，这可能是唯一的方法。 - Jeff Axelrod

Answer 3

在Eclipse中： 转到文件菜单->打开文件->浏览您的工作区项目目录->选择.classpath文件并打开它-> 在此文件中仅保留以下条目并删除所有其他条目。

`<?xml version="1.0" encoding="UTF-8"?>
<classpath>
<classpathentry kind="src" path="src"/>
<classpathentry kind="src" path="gen"/>
<classpathentry kind="lib" path="your dir path without space.../extras/android/support /v4/android-support-v4.jar"/>
<classpathentry kind="output" path="bin/classes"/>
 </classpath>

保存文件。 然后在Eclipse->包资源管理器->右键单击项目->Android工具->修复项目属性。

这将添加所有所需的文件到项目中，如果您想交叉检查，请再次打开.classpath文件并检查其中的更新。

成功运行项目 :)

- Niharika Rana