如何将本地 javadoc 文件夹附加到没有绝对路径的项目答案

【问题标题】：How do I attach a local javadoc folder to a project without an absolute path如何将本地 javadoc 文件夹附加到没有绝对路径的项目
【发布时间】：2012-06-11 02:32:08
【问题描述】：

我正在尝试附加 android-support-v4 的源代码并已按照此问题的说明进行操作：

How to install javadoc for Android Compatibility Package?

这个项目在 git repo 上共享，所以我不想签入指向本地文件夹的 .classpath。

在共享项目中指向此 javadoc 的最佳方式是什么？我愿意让其他人生成 javadoc，但我需要一种指向每个人的 Android SDK 目录的方法。不过，可以签入存储库的解决方案会更好。

我可以在指向 javadoc 文件夹的文件路径中使用变量吗？我希望有这样的东西：file:/$ANDROID_SDK_DIR$/extras/android/compatibility/v4/docs/

编辑： 我在与 javadocs 和 android 库的问题有关的 bug 上找到了 comment。我创建了属性文件，现在可以在 Eclipse 中看到 javadocs，但我仍然遇到同样的问题。该文件包含我自己的 Android SDK 目录的绝对路径。

【问题讨论】：

也许 Maven 可以为您提供更优雅的依赖管理方式（*.jar、*-source.jar 和 *-javadoc.jar），请参见示例 here。代价是你需要 mavenize 你的 Android 项目。
这确实是 ADT 17 引入的问题，但在 ADT 19 中尚未修复。
如果您查看编辑，在 ADT 20 Preview 3 中实现了一个解决方案，但即使是这个解决方案也不适合我。

标签： android javadoc

【解决方案1】：

我发现在新版本的 ADT 中，您必须在 libs 文件夹中包含一个 .properties 文件以及您的 jar。将 .classpath 更改为指向 docs/sources 的常规方法在带有 ADT 的 Eclipse 中不起作用，但这会。

如果您在文件 gson-2.2.2.jar 中有 GSON，请在同一文件夹中创建 gson-2.2.2.jar.properties

gson-2.2.2.jar.properties：

src=docs\\gson-2.2.2-sources.jar
doc=docs\\gson-2.2.2-javadoc.jar

然后在libs 中创建一个docs 文件夹并将您的源代码和javadoc jar 移入其中。

这解决了 /libs 中的任何内容都被编译到您的项目中的问题。仅包含根目录中的文件，因此为您的文档创建一个文件夹 (/libs/docs) 是处理此问题的好方法。

【讨论】：

【解决方案2】：

正如在这个解决方案中看到的那样，他在 SVN 存储库中有一个第三方库，他想在 Eclipse 中将 source/javadoc 与它本地关联。

我认为没有令人满意的解决方案，但您可以尝试。

检查这个solution，

希望对你有帮助。

【讨论】：

试过了，不行。这是库的特定于 Android 的问题。