运行 Eclipse

在将 Eclipse SDK 安装到一个目录中之后,可以通过运行发行版附带的 Eclipse 可执行文件来启动工作台(还需要并非由 Eclipse SDK 附带提供的 JRE SE 5 JRE)。在 Windows 上,此可执行文件名为 eclipse.exe,它在安装目录的 eclipse 子目录中。如果安装在 c:\eclipse-SDK-4.1-win32 上,那么可执行文件为 c:\eclipse-SDK-4.1-win32\eclipse\eclipse.exe注意:在大多数其他操作环境中的设置是相似的。下面列示了适用于 Mac OS X 的特殊指示信息。

分配足够的内存并解决内存不足错误

缺省情况下,Eclipse 将分配多达 384 兆字节的 Java 堆内存。对于所有典型的开发任务来说,这应该足够了。但是,根据所运行的 JRE、所使用的其他插件数以及处理的文件数的不同,可能必须增大此数量。Eclipse 允许您使用 -vmargs 命令行参数来将参数直接传递给 Java VM,这些参数必须在所有其他特定于 Eclipse 的参数后面指定。因此,要增加可用的堆内存,通常应该使用以下命令:

eclipse -vmargs -Xmx<内存大小>

其中,<内存大小> 值设置为大于 384M(缺省值为 384 兆字节)。

在使用 Oracle (Sun) VM 时,还可能需要增大永久代内存的大小。缺省最大值为 64 兆字节,但根据插件配置和用法的不同,可能需要更多内存。当 VM 耗尽永久代内存时,它在类装入期间可能会崩溃或挂起。在使用 Sun JRE V1.5.0_07 或更高版本时,此功能不常用。通过使用 -XX:MaxPermSize=<内存大小> 参数,可以增大最大永久代大小:

eclipse -vmargs -XX:MaxPermSize=<内存大小>

此参数可能不可用于所有 VM 版本和平台;请查阅 VM 文档以了解更多详细信息。

注意,如果将内存大小设置为大于机器上的可用物理内存量,将会导致 Java 在对虚拟内存复制对象时“崩溃”,这会严重影响性能。

选择工作空间

启动工作台后,您首先看到的是一个允许您选择工作空间位置的对话框。工作空间是将存储您的工作内容的目录。如果您未指定其他内容,Eclipse 就会在用户目录中创建工作空间。此工作空间目录将被用作项目的缺省内容区域,并且用于存储任何必需的元数据。对于共享安装或多工作空间安装来说,您必须使用此对话框(或通过“-data”命令行参数)明确指定工作空间的位置。

指定 Java 虚拟机

Eclipse 命令行如下所示:

eclipse -vm c:\jdk5u22\jre\bin\javaw

提示:通常,最好明确指定运行 Eclipse 时要使用的 Java VM。这是使用上述“-vm”命令行参数做到的。如果未使用“-vm”,Eclipse 就会查找操作系统路径。在安装其他基于 Java 的产品时,它们可能会更改路径,并可能会导致下次启动 Eclipse 时使用另一个 Java VM。

要创建已安装的 Eclipse 的 Windows 快捷方式:

  1. 在 Windows 资源管理器中浏览至 eclipse.exe,然后使用内容菜单上的“创建快捷方式”。
  2. 选择该快捷方式并编辑其属性。在“目标:”字段中,追加命令行参数。

打开此快捷方式时将启动 Eclipse。(为了方便地访问此快捷方式,可以将其拖放到桌面。)

Mac OS X

在 Mac OS X 上,可以通过双击 Eclipse 应用程序来启动 Eclipse。如果需要将参数传递给 Eclipse,那么必须编辑 Eclipse 应用程序捆绑软件 中的 eclipse.ini 文件:在按下 Control 键的情况下选择 Eclipse 应用程序捆绑软件图标。这将显示一个弹出菜单。请从该弹出菜单中选择“显示包内容”。找到 Contents/MacOS 子文件夹 中的 eclipse.ini 文件,使用您选择的文本编辑器将其打开,以编辑命令行选项。

在 MacOS X 上,仅当磁盘上有 UI 程序的多个副本时,才能多次启动该程序。此行为的原因是,Mac 上每个 UI 应用程序都可以打开多个文档,因此通常不需要打开同一个程序两次。由于 Eclipse 无法打开多个工作空间,因此,如果要同时打开多个工作空间,那么必须存在 Eclipse 安装版本的副本(错误 139319)。

如果需要从命令行启动 Eclipse,那么可使用顶层 Eclipse 文件夹中的符号链接“eclipse”。此链接引用应用程序捆绑软件中的 Eclipse 可执行文件,并且与其他平台上的“eclipse.exe”接受相同的参数。

在 Mac OS X 10.4 和更高版本上,如果允许 Spotlight 对工作空间建立索引,在使用大量资源时将会导致性能下降。为了防止发生这种情况,请打开“系统首选项”,选择 Spotlight 图标,然后打开“隐私”选项卡,然后单击“添加”按钮(“+”)并在显示的对话框中查找工作空间目录。

共享安装

如果在共享安装区中存储正确的高速缓存信息,那么可以提高共享安装的启动速度。为了实现此目标,在解压缩 Eclipse 分发包之后,请使用有权写安装目录的帐户来运行一次 Eclipse 并指定“-initialize”。

运行 Eclipse 中的高级主题

Eclipse 可执行文件及平台本身提供了人们感兴趣的开发或调试 Eclipse 各部件的许多执行选项。这是常用选项列表,有关完整列表,请参阅《平台插件开发者指南》中的 Eclipse 运行时选项页面。运行 Eclipse 可执行文件的一般格式是:

eclipse [platform options] [-vmargs [Java VM arguments]]
Eclipse 启动参数
命令 描述 原因
-arch architecture
定义 Eclipse 平台在其上运行的处理器体系结构。Eclipse 平台通常使用 Java os.arch 属性的常用值来计算最佳设置。如果在此处指定该项,那么这是 Eclipse 平台使用的值。此处指定的值可作为 Platform.getOSArch() 用于插件。示例值有:“x86”、“sparc”、“PA-RISC”和“ppc”。 2.0
-application applicationId
要运行的应用程序。应用程序由向 org.eclipse.core.runtime.applications 扩展点提供扩展的插件来声明。通常不需要此参数。如果指定了此项,那么该值会覆盖配置提供的值。如果不指定此项,那么会运行“Eclipse 工作台”。 1.0
-clean
清除由 OSGi 框架和 Eclipse 运行时使用的高速缓存数据。如果在执行安装后、执行更新后或使用共享配置时发生启动错误,请尝试在指定此选项的情况下运行一次 Eclipse。 3.0
-configuration configURL
Eclipse 平台配置文件的位置,表示为 URL。配置文件确定 Eclipse 平台、可用插件集和主要功能部件的位置。注意,不允许使用相对 URL。当安装或更新 Eclipse 平台时配置文件被写至此位置。 2.0
-consolelog
将 Eclipse 平台的错误日志镜像到用来运行 Eclipse 的控制台。与 -debug 组合时很方便使用。 1.0
-data workspacePath
要运行 Eclipse 平台的工作空间的路径。工作空间位置也是项目的缺省位置。相对于从中启动 eclipse 的目录来解释相对路径。 1.0
-debug [optionsFile]
将平台置于调试方式,并从给定位置处的文件装入调试选项(如果指定的话)。此文件指示哪些调试点可用于插件以及是否已启用它们。如果未给出文件位置,那么平台在启动 eclipse 的目录中查找称为“.options”的文件。URL 和文件系统路径都可作为文件位置。 1.0
-dev [classpathEntries]
将平台置于开发方式。将可选类路径条目(用逗号分隔的列表)添加至每个插件的运行时类路径。例如,当工作空间包含要开发的插件时,指定 -dev bin 会为每个插件项目的名为 bin 的目录添加类路径条目,允许在其中存储最新生成的类文件。除去了冗余或不存在的类路径条目。 1.0
-initialize
初始化要运行的配置。刷新与运行时相关的所有数据结构和高速缓存。对于共享安装来说非常方便:使用具有写特权的帐户来在指定此选项的情况下运行一次 Eclipse,能够提高启动性能。 3.0
-keyring keyringFilePath
磁盘上授权数据库(或“密钥环”文件)的位置。此参数必须与 -password 选项配合使用。相对于从中启动 eclipse 的目录来解释相对路径。 1.0
-nl locale
定义 Eclipse 平台在其上运行的语言环境的名称。Eclipse 平台通常自动计算最佳设置。如果在此处指定该项,那么这是 Eclipse 平台使用的值。此处指定的值可作为 Platform.getNL() 用于插件。示例值有:“en_US”和“fr_FR_EURO”。 2.0
-nosplash
运行平台而不显示启动屏幕。 1.0
-os operatingSystem
定义 Eclipse 平台在其上运行的操作系统。Eclipse 平台通常使用 Java os.name 属性的常用值来计算最佳设置。如果在此处指定该项,那么这是 Eclipse 平台使用的值。此处指定的值可作为 Platform.getOS() 用于插件,并用于解析在插件清单文件中提到的路径中所出现的 $os$ 变量。示例值有:“win32”、“linux”、“hpux”、“solaris”和“aix”。 1.0
-password password
权限数据库的密码。与 -keyring 选项配合使用。 1.0
-perspective perspectiveId
启动时要在活动工作台窗口中打开的透视图。如果没有指定该参数,那么将打开关闭时活动的透视图。 1.0
-plugincustomization
	  propertiesFile
包含插件首选项缺省设置的属性文件的位置。这些缺省设置覆盖在主要功能部件中指定的缺省设置。相对于从中启动 eclipse 的目录来解释相对路径。 2.0
-product productId
要运行的产品的标识。该产品为 Eclipse 的已启动实例提供了产品个性并确定使用的产品定制信息。此项替换 -feature,由于兼容性方面的原因,仍然支持后者。 3.0
-refresh 
启动时执行工作空间的全局刷新的选项。这将使从上次平台运行以来在文件系统中所做的任何更改一致。 1.0
-showlocation [workspaceName]
用于在窗口标题栏中显示工作空间的位置的选项。在发行版 2.0 中,此选项仅与 -data 命令行参数一起使用。在 3.2 中,添加了可选的工作空间名参数,该参数在窗口标题栏中显示所提供的名称,而不是显示工作空间的位置。 2.0
-vm vmPath
要用来运行 Eclipse 平台的“Java 运行时环境”(JRE)的位置。如果未指定此项,那么启动程序将尝试查找 JRE。它将首先查找作为 Eclipse 可执行文件同代的 jre 目录,然后在操作系统路径中进行查找。相对于从中启动 eclipse 的目录来解释相对路径。 1.0
-vmargs args
当传递至 Eclipse 时,此选项用来定制用来运行 Eclipse 的 Java VM 的操作。如果指定了此操作,此选项必须位于命令行的末尾。给定的参数依赖于要运行的 VM。 1.0

将 -vmargs 条目后面的所有参数(但不包括 -vmargs)作为虚拟机参数(即,在要运行的类的前面)直接传递到所指示的 Java VM。注意:如果 Eclipse 启动在 Java vm 参数(-vmargs)之后提供的参数(例如,-data),那么 Eclipse 将不会启动并且您将接收到“JVM 已终止。退出代码为 1”的错误。