Eclipse 運(yùn)行時(shí)選項(xiàng)

最后修改時(shí)間為 2004 年 8 月 4 日 14 點(diǎn) 45 分，星期三

Eclipse 平臺(tái)具有很高的可配置性。配置輸入的形式為命令行自變量和系統(tǒng)屬性設(shè)置。很多情況下，命令行自變量僅僅是用來設(shè)置相關(guān)系統(tǒng)屬性的縮寫。事實(shí)上，系統(tǒng)屬性設(shè)置遠(yuǎn)多于命令行自變量。

命令行自變量

下面列示的是由 Eclipse 運(yùn)行時(shí)的各個(gè)部分處理的命令行自變量。其中很多值也可通過使用系統(tǒng)屬性在命令行上使用 -D VM 自變量來指定或者通過在 config.ini 文件中指定這些值來指定。使用后一技巧，可以根本不使用命令行自變量就定制 Eclipse。

對于列表中的每個(gè)自變量，已經(jīng)給定了其對應(yīng)系統(tǒng)屬性關(guān)鍵字（在 {} 中）。另外還給定了處理命令行自變量的 Eclipse 運(yùn)行時(shí)層（在 () 中）。這對于人們替換運(yùn)行時(shí)部件以適應(yīng)特殊需要很有用。

-application <id> (Runtime)

相當(dāng)于將 eclipse.application 設(shè)置為 <id>

-arch <architecture> (OSGi)

相當(dāng)于將 osgi.arch 設(shè)置為 <architecture>

-clean (OSGi) NEW

相當(dāng)于將 osgi.clean 設(shè)置為 "true"

-configuration <location> (Main)

相當(dāng)于將 osgi.configuration.area 設(shè)置為 <location>

-console [port] (OSGi) NEW

相當(dāng)于將 osgi.console 設(shè)置為 [port] 或在要使用缺省端口（例如，未指定端口時(shí)）時(shí)設(shè)置為空字符串。

-consoleLog (Runtime)

相當(dāng)于將 eclispe.consoleLog 設(shè)置為 "true"

-data <location> (OSGi)

相當(dāng)于將 osgi.instance.area 設(shè)置為 <location>

-debug [options file] (OSGi)

相當(dāng)于將 osgi.debug 設(shè)置為 [options file] 或設(shè)置為空字符串以僅啟用調(diào)試（例如，如果未指定選項(xiàng)文件位置）

-dev [entries] (OSGi)

相當(dāng)于將 osgi.dev 設(shè)置為 [entries] 或設(shè)置為空字符串以僅啟用 DEV 方式（例如，如果未指定條目）

-endSplash <command> (Main)

指定要用來關(guān)閉閃屏的命令。通常由 Eclipse 可執(zhí)行文件提供。

-feature <feature id> (Runtime)

相當(dāng)于將 eclipse.product 設(shè)置為 <feature id>

-framework <location> (Main) NEW

相當(dāng)于將 osgi.framework 設(shè)置為 <location>

-initialize (Main)

初始化要運(yùn)行的配置。刷新與運(yùn)行時(shí)相關(guān)的所有數(shù)據(jù)結(jié)構(gòu)和高速緩存。不清除任何用戶／插件定義的配置數(shù)據(jù)。沒有運(yùn)行任何應(yīng)用程序，忽略所有產(chǎn)品規(guī)范且不顯示用戶界面（例如，不會(huì)繪制閃屏）

-install <location> (Main)

相當(dāng)于將 osgi.install.area 設(shè)置為 <location>

-keyring <location> (Runtime)

權(quán)限數(shù)據(jù)庫在磁盤上的位置。此自變量必須與 -password 自變量一起使用。

-nl <locale> (OSGi)

相當(dāng)于將 osgi.nl 設(shè)置為 <locale>

-noLazyRegistryCacheLoading (Runtime)

相當(dāng)于將 eclipse.noLazyRegistryCacheLoading 設(shè)置為 "true"

-noRegistryCache (Runtime)

相當(dāng)于將 eclipse.noRegistryCache 設(shè)置為 "true"

-noSplash (Executable, Main)

控制是否顯示閃屏

-os <operating system>（OSGi）

相當(dāng)于將 osgi.os 設(shè)置為 <operating system>

-password <password> (Runtime)

權(quán)限數(shù)據(jù)庫的密碼

-pluginCustomization <location> (Runtime)

相當(dāng)于將 eclipse.pluginCustomization 設(shè)置為 <location>

-product <id> (OSGi) NEW

相當(dāng)于將 eclipse.product 設(shè)置為 <id>

-showSplash <command> (Main)

指定要用來顯示閃屏的命令。通常由 Eclipse 可執(zhí)行文件提供。

-user <location> (OSGi) NEW

相當(dāng)于將 osgi.user.area 設(shè)置為 <location>

-vm <path to java executable> (Executable, Main) NEW

傳遞給 Eclipse 可執(zhí)行文件后，此選項(xiàng)用來查找用來運(yùn)行 Eclipse 的 Java VM。必須是指向適當(dāng)?shù)?Java 可執(zhí)行文件的完整文件系統(tǒng)路徑。如果未指定，Eclipse 可執(zhí)行文件將使用搜索算法來查找合適的 VM。不管怎樣，可執(zhí)行文件會(huì)使用 -vm 自變量將該路徑傳遞至用于 Java Main 的實(shí)際 VM。然后，Java Main 將此值存儲(chǔ)在 eclipse.vm 中。

-vmargs [vmargs*] (Executable, Main) NEW

傳遞給 Eclipse 后，此選項(xiàng)用來定制運(yùn)行 Eclipse 的 Java VM 的操作。如果指定了此操作，此選項(xiàng)必須位于命令行的末尾。即使未在可執(zhí)行命令行上指定，可執(zhí)行文件也將使用 -vmargs 自變量自動(dòng)將相關(guān)自變量（包括正在啟動(dòng)的類）添加至傳遞到 Java 的命令行。然后，Java Main 將此值存儲(chǔ)在 eclipse.vmargs 中。

-ws <window system> (OSGi)

相當(dāng)于將 osgi.ws 設(shè)置為 <window system>

廢棄的命令行自變量

下列命令行自變量不再相關(guān)或已被取代，并由運(yùn)行時(shí)占用而不傳遞至為保留向后兼容性而運(yùn)行的應(yīng)用程序。

-boot

請參閱 -configuration

-classLoaderProperties

不再相關(guān)

-firstUse

不再相關(guān)

-newUpdates

不再相關(guān)

-noPackagePrefixes

不再相關(guān)

-noUpdate

不再相關(guān)

-plugins

不再相關(guān)

-update

不再相關(guān)

其它

下列命令行自變量是由各個(gè) Eclipse 插件定義的，且僅當(dāng)安裝、解析并激活定義插件后才受支持。

-noVersionCheck (workbench)

<description>

-perspective (workbench)

<description>

-refresh (org.eclipse.core.resources)

<description>

-showLocation (org.eclipse.ui.ide.workbench)

<description>

-allowDeadlock

<description>

系統(tǒng)屬性

Eclipse 運(yùn)行時(shí)使用下列系統(tǒng)屬性。注意，以“osgi”開頭的屬性是特定于 OSGi 框架實(shí)現(xiàn)的，而以“eclipse”開頭的屬性則特定于位于 OSGi 框架之上的 Eclipse 運(yùn)行時(shí)。

其中許多屬性具有命令行等效項(xiàng)（請參閱命令行自變量一節(jié)以及花括號 {} 中的值）。用戶可任意選用命令行或?qū)傩栽O(shè)置來指定值。可以下列方式設(shè)置屬性：

• 使用 -DpropName=propValue 作為 Java VM 的 VM 自變量
• 在 config.ini 文件中的適當(dāng)配置區(qū)域設(shè)置想要的屬性

eclipse.application {-application}

要運(yùn)行的應(yīng)用程序的標(biāo)識(shí)。此處給定的值覆蓋由要運(yùn)行的產(chǎn)品（請參閱 eclipse.product）定義的任何應(yīng)用程序。

eclipse.commands

sdf

eclipse.consoleLog

如果為“true”，還將任何日志輸出發(fā)送至 Java 的 System.out（通常會(huì)返回至命令 shell）。與 -debug 組合時(shí)很方便。

eclipse.debug.startupTime

啟動(dòng)用于此會(huì)話的 Java VM 的時(shí)間（以毫秒計(jì)）

eclipse.exitcode

<description>

eclipse.exitdata

<description>

eclipse.manifestConverter

將舊的 plugin.xml 文件轉(zhuǎn)換為 manifest.mf 文件時(shí)使用的清單轉(zhuǎn)換器類的類名

eclipse.noExtensionMunging

如果為“true”，舊注冊表擴(kuò)展將保持原樣。缺省情況下，將更新這些擴(kuò)展以使用 Eclipse 3.0 中的新擴(kuò)展點(diǎn)標(biāo)識(shí)。

eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}

如果為“true”，將釋放平臺(tái)的插件注冊表高速緩存裝入優(yōu)化。缺省情況下，僅在需要時(shí)才從注冊表高速緩存（如果有）裝入配置元素，從而減少內(nèi)存占用量。此選項(xiàng)在啟動(dòng)時(shí)強(qiáng)制完全裝入注冊表高速緩存。

eclipse.noRegistryCache {-noRegistryCache}

如果為“true”，則不會(huì)讀寫內(nèi)部擴(kuò)展注冊表高速緩存

eclipse.pluginCustomization {-pluginCustomization}

包含插件首選項(xiàng)的缺省設(shè)置的屬性文件的文件系統(tǒng)位置。這些缺省設(shè)置覆蓋在主要功能部件中指定的缺省設(shè)置。相對路徑是相對于 Eclipse 本身的當(dāng)前工作目錄解釋的。

eclipse.product {-product}

要運(yùn)行的產(chǎn)品的標(biāo)識(shí)。它控制各種品牌信息以及使用的應(yīng)用程序。

eclipse.vm {-vm}

指向用來運(yùn)行 Eclipse 的 Java 可執(zhí)行文件的路徑。此信息用來構(gòu)造重新啟動(dòng)命令行。

eclipse.vmargs {-vmargs}

列示用來運(yùn)行 Eclipse 的 VM 自變量。此信息用來構(gòu)造重新啟動(dòng)命令行。

osgi.adaptor

要使用的 OSGi 框架適配器的類名。

osgi.arch {-arch}

請參閱 -arch

osgi.baseConfiguration.area

asf

osgi.bundles

用逗號分隔的 bundle 列表，它們是自動(dòng)安裝的，在系統(tǒng)啟動(dòng)并運(yùn)行后可選擇啟動(dòng)它們。每個(gè)條目的格式是：

    <URL | simple bundle location>[@ [<start-level>] [":start"]]

如果省略啟動(dòng)級別（大于零的整數(shù)），則框架將對 bundle 使用缺省啟動(dòng)級別。如果添加了“start”標(biāo)記，則在安裝后，會(huì)將 bundle 標(biāo)記為已啟動(dòng)。簡單 bundle 位置是相對于框架的父目錄解釋的。啟動(dòng)級別指示 bundle 應(yīng)該運(yùn)行于的 OSGi 啟動(dòng)級別。如果未設(shè)置此值，系統(tǒng)將計(jì)算適當(dāng)?shù)娜笔≈怠?

osgi.clean

如果設(shè)置為 "true"，則 OSGi 框架和 eclipse 運(yùn)行時(shí)所用的任何高速緩存的數(shù)據(jù)將被全部擦去。這將清理用來存儲(chǔ) bundle 從屬項(xiàng)資源和 eclipse 擴(kuò)展注冊數(shù)據(jù)的高速緩存。使用此選項(xiàng)將強(qiáng)制 eclipse 重新初始化這些高速緩存。

osgi.configuration.cascaded

如果設(shè)置為“true”，將把此配置層疊至父代配置。有關(guān)詳細(xì)信息，請參閱有關(guān)位置的一節(jié)。

osgi.configuration.area {-configuration}

此次平臺(tái)運(yùn)行的配置位置。配置決定哪些插件將運(yùn)行以及其它各項(xiàng)系統(tǒng)設(shè)置。有關(guān)詳細(xì)信息，請參閱有關(guān)位置的一節(jié)。

osgi.configuration.area.default

此次平臺(tái)運(yùn)行的缺省配置位置。配置決定哪些插件將運(yùn)行以及其它各項(xiàng)系統(tǒng)設(shè)置。僅當(dāng)未對 osgi.configuration.area 設(shè)置任何值時(shí)才使用此值（即，缺省設(shè)置）。有關(guān)詳細(xì)信息，請參閱有關(guān)位置的一節(jié)。

osgi.console {-console}

如果設(shè)置為非空值，則將啟用 OSGi 控制臺(tái)（如果安裝了）。如果該值是合適的整數(shù)，將把它解釋為端口，控制臺(tái)在該端口上偵聽其輸出并引導(dǎo)至給定端口。便于調(diào)查系統(tǒng)的狀態(tài)。

osgi.console.class

要運(yùn)行的控制臺(tái)的類名（如果已請求）

osgi.debug {-debug}

如果設(shè)置為非空值，平臺(tái)將置于調(diào)試方式。如果此值是字符串，則將它解釋為 .options 文件的位置。此文件指示哪些調(diào)試點(diǎn)可供插件使用以及是否啟用了它們。如果未指定位置，平臺(tái)將在安裝目錄下搜索 .options 文件。

osgi.dev {-dev}

如果設(shè)置為空字符串，就會(huì)打開 DEV 方式。還可將此屬性設(shè)置為用逗號分隔的將添加至每個(gè)插件的類路徑的類路徑條目或設(shè)置為指向包含一組插件的定制類路徑添加項(xiàng)的 Java 屬性文件的 URL。對于要求定制的 DEV 時(shí)間類路徑的每個(gè)插件，該文件都將包含以下格式的條目：

    <插件標(biāo)識(shí)>=<用逗號分隔的要添加的類路徑條目的列表>

其中插件標(biāo)識(shí)“*”與另行聲明的所有插件匹配。

osgi.framework

OSGi 框架的 URL 位置。當(dāng) Eclipse 安裝中斷時(shí)很有用。有關(guān)詳細(xì)信息，請參閱有關(guān)位置的一節(jié)。

osgi.frameworkClassPath

用逗號分隔的用于 OSGi 框架實(shí)現(xiàn)的類路徑條目的列表。相對位置是相對于框架位置解釋的（請參閱 osgi.framework）

osgi.install.area {-install}

平臺(tái)的安裝位置。此設(shè)置指示基本 Eclipse 插件的位置，在 Eclipse 安裝中斷時(shí)很有用。有關(guān)詳細(xì)信息，請參閱有關(guān)位置的一節(jié)。

osgi.instance.area {-data}

此會(huì)話的實(shí)例數(shù)據(jù)位置。插件使用此位置來存儲(chǔ)它們的數(shù)據(jù)。例如，資源插件使用這個(gè)作為項(xiàng)目的缺省位置（aka 工作空間）。有關(guān)詳細(xì)信息，請參閱有關(guān)位置的一節(jié)。

osgi.instance.area.default

此會(huì)話的缺省實(shí)例數(shù)據(jù)位置。插件使用此位置來存儲(chǔ)它們的數(shù)據(jù)。例如，資源插件使用這個(gè)作為項(xiàng)目的缺省位置（aka 工作空間）。僅當(dāng)未對 osgi.instance.area 設(shè)置任何值時(shí)才使用此值（即，缺省設(shè)置）。有關(guān)詳細(xì)信息，請參閱有關(guān)位置的一節(jié)。

osgi.manifest.cache

發(fā)現(xiàn)和生成的清單的位置。缺省位置在配置區(qū)域中，但清單高速緩存可以單獨(dú)存儲(chǔ)。

osgi.nl {-nl}

Eclipse 平臺(tái)將在其上運(yùn)行的語言環(huán)境的名稱。NL 值應(yīng)遵循標(biāo)準(zhǔn) Java 語言環(huán)境命名約定。

osgi.os {-os}

操作系統(tǒng)值。該值應(yīng)為 Eclipse 已知的 Eclipse 處理器體系結(jié)構(gòu)名稱之一（例如，x86 和 sparc 等等）。

osgi.splashLocation

啟動(dòng) Eclipse 時(shí)要顯示的閃屏（.bmp 文件）的絕對 URL 位置。此屬性覆蓋 osgi.splashPath 中設(shè)置的任何值。

osgi.splashPath

用逗號分隔的用來搜索名為 splash.bmp 的文件的 URL 的列表。此屬性被在 osgi.splashLocation 中設(shè)置的任何值覆蓋。

osgi.user.area {-user}

用戶區(qū)域的位置。用戶區(qū)域包含特定于操作系統(tǒng)用戶而且獨(dú)立于任何 Eclipse 安裝、配置或?qū)嵗臄?shù)據(jù)（例如，首選項(xiàng)）。有關(guān)詳細(xì)信息，請參閱有關(guān)位置的一節(jié)。

osgi.user.area.default

用戶區(qū)域的缺省位置。用戶區(qū)域包含特定于操作系統(tǒng)用戶而且獨(dú)立于任何 Eclipse 安裝、配置或?qū)嵗臄?shù)據(jù)（例如，首選項(xiàng)）。僅當(dāng)未對 osgi.user.area 設(shè)置任何值時(shí)才使用此值（即，缺省設(shè)置）。有關(guān)詳細(xì)信息，請參閱有關(guān)位置的一節(jié)。

osgi.ws {-ws}

窗口系統(tǒng)值。該值應(yīng)為 Eclipse 已知的 Eclipse 窗口系統(tǒng)名稱之一（例如，win32 和 motif 等等）。

osgi.syspath

<仍在使用 xxx？修正名稱>

位置

Eclipse 運(yùn)行時(shí)定義一些位置，給插件開發(fā)者提供讀取／存儲(chǔ)數(shù)據(jù)的上下文并使 Eclipse 用戶能控制數(shù)據(jù)共享作用域和可視性。Eclipse 定義下列位置概念：

User (-user) {osgi.user.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]

顧名思義，用戶位置是特定于用戶的。通常，用戶位置是基于 Java user.home 系統(tǒng)屬性的值，但是，可覆蓋此值。在用戶位置中可找到諸如用戶范圍的首選項(xiàng)和登錄信息之類的信息。

Install (-install) {osgi.install.area} [@user.home, @user.dir, filepath, url]

安裝位置是安裝 Eclipse 本身的地方。實(shí)際上此位置是要運(yùn)行 startup.jar 或 eclipse.exe 的父代的目錄（通常為“eclipse”）。對于普通用戶，應(yīng)將此位置視為只讀，因?yàn)榘惭b可由許多用戶共享。可設(shè)置安裝位置并從 Eclipse 的其余部分對 startup.jar 去耦。

Configuration (-configuration) {osgi.configuration.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]

配置位置包含標(biāo)識(shí)和管理要運(yùn)行的安裝的（子）集的文件。這樣，每個(gè)安裝可能會(huì)有許多配置。安裝可能附帶缺省配置區(qū)域，但通常的啟動(dòng)方案涉及查找可寫度更高的配置位置的運(yùn)行時(shí)嘗試。

Instance (-data) {osgi.instance.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]

包含用戶定義的數(shù)據(jù)構(gòu)件的實(shí)例位置。例如，資源插件使用實(shí)例區(qū)域作為工作空間位置，因此它是項(xiàng)目的缺省主目錄。其它插件可在此位置中隨意寫下任何文件。

雖然用戶可以設(shè)置這些位置當(dāng)中的任何一個(gè)，但是如果沒有給定值，Eclipse 將計(jì)算出合理的缺省值。設(shè)置位置最常見的用例就是實(shí)例區(qū)域或工作空間（在 IDE 環(huán)境中）。要對特定數(shù)據(jù)集運(yùn)行缺省 Eclipse 配置，可指定：

    eclipse -data c:\mydata

更多詳細(xì)信息

位置是一些 URL。為簡單起見，也接受文件路徑并且它們將自動(dòng)轉(zhuǎn)換為 file: URL。為更好地控制以及更方便起見，還有一些可以使用的預(yù)定義符號位置。注意，并非位置類型和符號值的所有組合都有效。下表詳細(xì)說明了哪些組合是可能的。由于缺省用例用于要設(shè)置的所有位置，而且它是有效且可寫的，因此有些插件在其它設(shè)置中可能會(huì)失效，即使它們被列示為可行也是如此。例如，如果未定義實(shí)例區(qū)域，期望重點(diǎn)放在用戶數(shù)據(jù)上的插件（例如，Eclipse 資源插件）來完成許多任務(wù)是不合理的。將由插件開發(fā)者來選擇他們支持的設(shè)置并相應(yīng)地設(shè)計(jì)它們的功能。

@none

指示不應(yīng)顯式設(shè)置相應(yīng)位置或設(shè)置為其缺省值。例如，沒有用戶數(shù)據(jù)的 RCP 樣式應(yīng)用程序可以使用 osgi.instance.area=@none 來防止將外來文件寫入磁盤。@none 后面不能跟任何其它路徑段。

@noDefault

強(qiáng)制取消位置的定義或顯式定義位置（即，Eclipse 不會(huì)自動(dòng)計(jì)算缺省值）。這在您想在相應(yīng)的位置允許數(shù)據(jù)但 Eclipse 缺省值不合適的時(shí)候很有用。@noDefault 后面不能跟任何其它路徑段。

@user.home

引導(dǎo) Eclipse 計(jì)算相對于用戶的主目錄的位置值。@user.home 后面可跟其它路徑段。在所有情況下，字符串“@user.home”僅被替換為 Java“user.home”系統(tǒng)屬性的值。例如，設(shè)置
    osgi.instance.area=@user.home/myWorkspace
將導(dǎo)致值
    file:/users/bob/myWorkspace

@user.dir

引導(dǎo) Eclipse 計(jì)算相對于當(dāng)前工作目錄的位置值。@user.dir 后面可跟其它路徑段。在所有情況下，字符串“@user.dir”僅被替換為 Java“user.dir”系統(tǒng)屬性的值。例如，設(shè)置
    osgi.instance.area=@user.dir/myWorkspace
將導(dǎo)致值
    file:/usr/share/eclipse/myWorkspace

* 指示此設(shè)置是在技術(shù)上可行但實(shí)際操作時(shí)很難管理。特別是在沒有配置位置的情況下，Eclipse 運(yùn)行時(shí)可能只能啟動(dòng) OSGi 框架而已。