Eclipse 如何将包含 javadocs/source 的 jar 与其二进制文件链接？答案

【问题标题】：Eclipse how to link a jar containing javadocs/source with its binary?Eclipse 如何将包含 javadocs/source 的 jar 与其二进制文件链接？
【发布时间】：2023-03-23 09:52:02
【问题描述】：

当我将鼠标悬停在某个类上时，我希望 jar 文件中包含的 javadoc cmets 显示在 Eclipse 中。

例如下载JODA-2.0后，得到三个jar：

joda-time-2.0
joda-time-2.0-javadoc
joda-time-2.0-来源 (http://sourceforge.net/projects/joda-time/files/joda-time/2.0/joda-time-2.0-dist.zip/download)

在 Eclipse 中，[右键单击项目 -> 属性 -> Java 构建路径 -> 库 -> 添加 JAR...] 包含项目中的二进制文件（可以引用那些类），用于 joda-time-2.0.jar。

但是如何链接其他两个 jar 文件中包含的源/javadoc cmets，以便当我将鼠标悬停在这些类上时，我可以看到 javadocs？

将其他两个 jar（joda-time-2.0-javadoc.jar 和 joda-time-2.0-sources.jar）添加到构建路径不会链接 javadocs 或源代码。

【问题讨论】：

标签： java eclipse jar javadoc

【解决方案1】：

在项目上右击->构建路径->配置构建路径
在新窗口中，转到“库”标签。
选择库并展开它。
有 4 个子选项。选择“Javadoc 位置”并点击右侧的“编辑”按钮。
现在您可以添加一个包含文档的 jar 文件。这将只是一个扩展名为 jar 的 zip 文件。确保在 jar 中 index.html 位于根目录中。您可以按“验证”按钮检查一切是否正常。

【讨论】：

to 3.直接选择库，而不是Android Private Libraries中列出的库（没有编辑功能）。至 4：在档案中使用 Javadoc，而不是 URL
只是补充一点，如果您使用的是公共库，您可以在线附加 API 链接，而不是 JAR 文件的硬编码本地路径。

【解决方案2】：

您可以尝试 CTRL + 单击没有附加源的类（在编辑器中执行此操作）。当它向您显示有关该课程的一些信息时，您将看到指导附加源对话框的按钮。单击它，然后在弹出的对话框中为您的类选择源/javadoc 位置。

您也可以从您提到的项目构建路径设置中执行此操作：选择库选项卡，展开您想要的库 (jar)，然后您可以选择：源附件、javadoc 附件、本机库位置等。您只需选择您想要的任何内容并编辑其当前设置。

或者你可以像@JB Nizet 所说的那样做......

【讨论】：

附加 source 与附加 javadoc 有什么区别？
@Pacerier source 包含程序源代码，其中 javadoc 包含解释程序功能的文档和 cmets。
我收到消息“此类文件的 JAR 属于容器‘Android 私有库’，它不允许修改其条目上的源附件

【解决方案3】：

右键单击 jar（带有类文件的那个），选择“属性”，“Javadoc 位置”，然后选择带有 javadoc 的 jar 文件。使用“Java 源附件”对源 jar 执行类似操作。

【讨论】：

可能只是我，但这只有在 Eclipse 将文件“识别”为 jar 时才有效。就是它旁边有一个小罐子图标。当我导入第 3 方 jar 时，它们会显示为文档图标。它们在代码方面工作得很好，但右键单击属性我没有得到“javadoc位置”。
如果您的 jars 位于 WEB-INF/lib 中，则不应右键单击它们（如您所说，它们显示为文档），而应从“Web App Libraries”中的等效项中单击/跨度>

【解决方案4】：

您还可以在 Eclipse 项目中编辑文件“.classpath”中的类路径条目。如果您想一次修改多个条目或如果您想生成路径，这会很有帮助。例如：

<classpathentry kind="var" path="HOME/3rdparty/junit.jar" sourcepath="/SOURCE/junit_src.zip"/>

【讨论】：

+1 答案！我正在考虑这样一种方法，可以一次为各种罐子添加。
-1 您不想直接编辑 .classpath 文件。它仅供 eclipse 使用，不能手动编辑。 @Mister Smith 实际上在这里给出了真正正确的答案。虽然draganstankovic 解释了一种至少可以完成工作的方法......
@scribaniwannabe：我知道这既不是预期的、受支持的方式，也不是最简单的方式，但对于我提到的用例，它运行得更快而且没有问题。但是，您必须小心使用有效的 XML 语法。

【解决方案5】：

最简单的方法是：

按 control+（您要查看 Java 文档的单词）
将出现一个页面，其中有一个附加源按钮。单击此
选择外部位置。
浏览Java文件夹的位置比你的jdk。比选择 src.zip。
按确定。

问题解决了。

【讨论】：