我是 Eclipse 的新手,不知道如何在编辑时显示 SWT 和 JFace 的 JavaDocs。
我该怎么做呢?谢谢!
我假设您已经自己下载了 jar 并在您的项目中引用了它们。如果是这样,您可以右键单击项目资源管理器中的 jar(在“引用库”节点中),然后单击“属性”。出现的窗口中,您可以定义 jar 的 JavaDoc 和源代码(如果有的话)的位置。
您还可以通过单击 Project > Properties > Java Build Path > Libraries 并展开要添加 javadoc/source 的 jar 的节点来实现此目的。
另外值得一提的是,如果您使用 Maven ( http://maven.apache.org/ ) 来构建您的项目,它的依赖管理系统将负责为您查找源代码和 javadocs。但这完全是一个不同的话题。也可能值得一看 Ivy ( http://ant.apache.org/ivy/ ) - 类似的依赖管理系统,但可以在不将你的灵魂卖给 Maven 的情况下使用,我被告知。
您可能还意味着您实际上看不到 javadocs:Window > Show View > Other... > Java > JavaDoc。此视图将向您显示当前关注的任何内容的 javadoc。或者只需将鼠标悬停在一个方法上即可在弹出窗口中查看 javadoc。
根据 ukulele 的建议,我能够右键单击 jar 并设置 javadoc 位置。在这种情况下,在线 javadoc 的位置是:
http://help.eclipse.org/stable/nftopic/org.eclipse.platform.doc.isv/reference/api/
从 SWT 网站找到:
http://www.eclipse.org/swt/docs.php
谢谢!
如果您希望在 Eclipse 中安装所有内容(包括插件)的 JavaDoc,请安装“Eclipse SDK”。这个的更新站点是
download.eclipse.org/eclipse/updates/4.4
(这是针对 eclipse juno 的。对于开普勒,使用版本号 4.3 而不是 4.4)
转到Help > Install New Software...
并提供上述“使用”部分的 url。然后你应该选择“Eclipse SDK”并安装它。
安装并重新启动 eclipse 后,只要将鼠标悬停在特殊关键字上,所有文档都将在您的编辑器中可见。
相信我,这是最简单且 100% 正确的方法。
为了进一步澄清这会发生什么,它将为“org.eclipse.swt.gtk.linux.x86_64_3.102.1.v20140206-1358.jar”和“org.eclipse.swt_3.102.1.v20140206-1334”配置javadoc路径.jar”(或在 windows org.eclipse.swt.win32.win32.x86_643.xxxx.jar 中)并且在项目结构的插件依赖项中可见。所以要手动设置javadoc支持右键单击项目>构建路径>配置构建路径>在库选项卡>插件依赖项下选择与swt相关的.jar(对于windows org.eclipse.swt.win32.win32.x86_643.xxxx.jar对于 linux org.eclipse.swt.gtk.linux.x86_64_xxxxxxx.jar) 展开它并设置 javadoc 位置。对于 java doc 位置,您应该将 org.eclipse.platform.doc.isv_4.3.0.v20130606-0003.jar 的存档路径指定为“
如果您使用“插件项目”,默认情况下它们就在那里。该项目类型在“Eclipse for RCP/Plug-in Developers”或“Eclipse Classic”中可用。如果您有不同的版本,您应该能够在通过更新管理器安装“Eclipse SDK”功能后设置这样的项目(在 3.4 中的可用软件 -> Eclipse 项目更新下)。
我经常发现 eclipse.org 上的 javadoc 加载速度非常慢。javadocs 可能包含在您的 eclipse 安装中,因此可以在本地使用;尝试Help->Help Contents菜单并搜索“SWT”以查看您的安装是否属实。
一种方法是将 SWT 源 jar(例如org.eclipse.swt.gtk.linux.x86_64.source_3.7.0.v3735b.jar
)从eclipse/plugins
目录附加到引用的库。您将能够查看源代码和 Javadoc。
如果您正在使用 org.eclipse.jface.text 进行开发,还可以将 org.eclipse.jface.text jar 的 javadoc 位置编辑为:
http://help.eclipse.org/indigo/topic/org.eclipse.platform.doc.isv/reference/api/