ChatGPT解决这个技术问题 Extra ChatGPT

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

当我将鼠标悬停在一个类上时,我希望在 Eclipse 中显示包含在 jar 文件中的 javadoc 注释。

比如下载JODA-2.0后,得到三个jar:

乔达时间2.0

joda-time-2.0-javadoc

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

在 Eclipse 中,[右键单击项目 -> 属性 -> Java 构建路径 -> 库 -> ADD JAR...] 在项目中包含二进制文件(可以引用这些类),用于 joda-time-2.0.jar。

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

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


M
Mister Smith

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


3.直接选择库,而不是Android Private Libraries中列出的库(没有编辑功能)。 To 4:在档案中使用 Javadoc,而不是 URL
只是要补充一点,如果您使用的是公共库,则可以在线附加 API 链接,而不是 JAR 文件的硬编码本地路径。
d
draganstankovic

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

您也可以从您提到的项目构建路径设置中执行此操作:选择库选项卡,展开您想要的库(jar),您将可以选择:源附件、javadoc 附件、本机库位置等。您只需选择无论您想要什么并编辑其当前设置。

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


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

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


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

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

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


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

最简单的方法是:

按 control+(您要查看 Java 文档的单词)将出现一个页面,其中有一个附加源按钮。单击此选择外部位置。浏览 Java 文件夹的位置,而不是你的 jdk 。然后选择 src .zip。按确定。

问题已经解决了。