Eclipse 執行時期選項

3.2 版 - 前次修訂 2006 年 5 月 8 日

Eclipse 平台具有高度的可配置性。 配置輸入採取指令行引數和系統內容設定的形式。 在許多情況下,指令行引數都只是設定相關系統內容的捷徑。 事實上,系統內容設定的數目比指令行引數還多。

指令行引數

下面列出 Eclipse 執行時期各個部分所處理的指令行引數。 您可以在指令行中使用 -D VM 引數、在 config.ini 檔中指定這些值,或使用 <launcher>.ini 檔,來利用「系統」內容指定這些值。 如果使用後二種技術,您完全不需要使用指令行引數,就可以自訂您的 Eclipse。

清單中每個引數都有對應的系統內容鍵(在 {} 中)。 另外還有處理指令行引數的 Eclipse 執行時期層次(在 () 中)。 對於想要取代執行時期的各個部分來配合特殊需求的人而言,這非常有用。

-application <id> (Runtime)
等於是將 eclipse.application 設為 <id>
-arch <architecture> (OSGi)
等於是將 osgi.arch 設為 <architecture>
-clean (OSGi)
equivalent to setting osgi.clean to "true"
-configuration <location> (Main)
等於是將 osgi.configuration.area 設為 <location>
-console [port] (OSGi)
如果要使用預設埠(也就是在未指定埠時),等於是將 osgi.console 設為 [port] 或空字串
-consoleLog (Runtime)
等於是將 eclipse.consoleLog 設為 "true"
-data <location> (OSGi)
等於是將 osgi.instance.area 設為 <location>
-debug [options file] (OSGi)
等於是將 osgi.debug 設為 [options file] 或空字串,只啟用除錯(也就是在未指定 options file 位置的情況下)
-dev [entries] (OSGi)
等於是將 osgi.dev 設為 [entries] 或空字串,只啟用 dev 模式(也就是在未指定 entries 的情況下)
-endSplash <command> (Main)
指定要用來取得歡迎畫面的指令。 通常由 Eclipse 執行檔來提供。
-feature <feature id> (Runtime)
等於是將 eclipse.product 設為 <feature id>
-framework <location> (Main)
等於是將 osgi.framework 設為 <location>
-initialize (Main)
起始所執行的配置。 所有執行時期相關資料結構和快取記憶體都會自動更新。 不會除去任何使用者/外掛程式定義的配置資料。 不會執行任何應用程式,任何產品規格都會被忽略,不會呈任何 UI(如不會顯示歡迎畫面)
-install <location> (Main)
等於是將 osgi.install.area 設為 <location>
-keyring <location> (Runtime)
磁碟上的授權資料庫位置。這個引數必須結合 -password 引數來使用。
-name <string> NEW
啟動應用程式時,要顯示在作業列項目的名稱。如果未設定,則名稱會是執行檔的名稱。
-nl <locale> (OSGi)
等於是將 osgi.nl 設為 <locale>
-noExit (OSGi)
等於是將 osgi.noShutdown 設為 "true"
-noLazyRegistryCacheLoading (Runtime)
等於是將 eclipse.noLazyRegistryCacheLoading 設為 "true"
-noRegistryCache (Runtime)
等於是將 eclipse.noRegistryCache 設為 "true"
-noSplash (Executable, Main)
控制是否顯示歡迎畫面
-os <operating system> (OSGi)
等於是將 osgi.os 設為 <operating system>
-password <password> (Runtime)
授權資料庫的密碼
-pluginCustomization <location> (Runtime)
等於是將 eclipse.pluginCustomization 設為 <location>
-product <id> (OSGi)
等於是將 eclipse.product 設為 <id>
-showSplash <command> (Main)
指定要用來顯示歡迎畫面的指令。通常由 Eclipse 執行檔來提供。
-startup <location> (Executable) NEW
用來啟動 Eclipse 之 JAR 的位置。參照的 JAR 必須設定「主要類別」屬性。 如果未設定這個參數,則會使用 startup.jar,其位於與執行檔所在的相同資料夾中。
-user <location> (OSGi)
等於是將 osgi.user.area 設為 <location>
-vm <path to java executable> (Executable, Main)
當傳給 Eclipse 執行檔時,這個選項用來尋找執行 Eclipse 時所用的 Java VM。 它必須是適當 Java 執行檔的完整檔案系統路徑。 如果未指定的話,Eclipse 執行檔會利用搜尋演算法來尋找適當的 VM。 之後,不論在任何事件中,執行檔都會利用 -vm 引數,將所用的實際 VM 的路徑傳給 Java Main。 之後,Java Main 會將這個值儲存在 eclipse.vm 中。
-vmargs [vmargs*] (Executable, Main)
當傳給 Eclipse 時,這個選項用來自訂執行 Eclipse 時所用的 Java VM 作業。 如果指定的話,這個選項必須在指令行的尾端。 即使未在執行檔指令行上執行,執行檔也會自動利用 -vmargs 引數,將相關的引數(包括啟動的類別)加到傳給 Java 的指令行。 之後,Java Main 會將這個值儲存在 eclipse.vmargs 中。
-ws <window system> (OSGi)
等於是將 osgi.ws 設為 <window system>

已作廢的指令行引數

下列指令行已不再相關或已被取代,它們由執行時期使用,不會傳給所執行的應用程式來維護舊版相容性。 .

-boot
請參閱 -configuration
-classLoaderProperties
已不再相關
-firstUse
已不再相關
-newUpdates
已不再相關
-noPackagePrefixes
已不再相關
-noUpdate
已不再相關
-plugins
已不再相關
-update
已不再相關

其他

下列指令行引數由各種 Eclipse 外掛程式來定義,只有在定義它們的外掛程式已安裝、解析和啟動時,它們才會受到支援。

-noVersionCheck (workbench)
<description>
-perspective (workbench)
<description>
-refresh (org.eclipse.core.resources)
<description>
-showLocation (org.eclipse.ui.ide.workbench)
<description>
-allowDeadlock
<description>

系統內容

Eclipse 執行時期使用下列系統內容。 請注意,開頭是 "osgi" 的系統內容是 OSGi 架構實作專用的系統內容, 開頭是 "eclipse" 的系統內容是在 OSGi 架構上的 Eclipse 執行時期層次專用的系統內容。

許多這些內容都有指令行對等項目(請參閱指令行引數一節,以及大括號 {} 中的值)。 使用者可以使用指令行或內容設定來指定值。 您可以依照下列方式來設定內容:

eclipse.activateRuntimePlugins
控制執行時期外掛程式的啟動。 不需要執行時期外掛程式提供之服務的 RCP 應用程式,可以將這個內容設為 "false",以避免在 Eclipse 啟動時啟動執行時期外掛程式。
eclipse.application {-application}
要執行的應用程式 ID。這裡提供的值用來置換執行的產品所定義的任何應用程式(請參閱 eclipse.product
eclipse.commands
啟動 Eclipse 時,會傳送所有指令行引數的清單(以換行分隔)。
eclipse.consoleLog
如果是 "true",任何日誌輸出也都會傳送到 Java 的 System.out(如果有的話,通常也會傳回指令 Shell)。 當結合 -debug 使用時,非常方便
eclipse.debug.startupTime
啟動這個階段作業的 Java VM 的時間(毫秒)
eclipse.ee.install.verify
如果設為 "true",架構會在軟體組安裝時,檢查所需要的執行環境。 預設值是 "false"。
eclipse.log.backup.max
允許的備份日誌檔數目上限。因旋轉日誌檔而達到備份日誌檔的數目上限後,會刪除最早的備份日誌檔。 預設值是 "10"。負數或零值會導致使用預設值。
eclipse.log.size.max
允許日誌檔成長的大小上限 (KB)。檔案大小超出大小上限時,日誌檔便會旋轉。預設值是 "1000"。 負數值會導致使用預設值。零值表示沒有日誌檔大小上限。
eclipse.noExtensionMunging
如果是 "true",舊式登錄延伸規格就會依現狀保留下來。 依預設,會更新這些延伸規格來使用在 Eclipse 3.0 中找到的新延伸點 ID。
eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}
如果是 "true",就會取消啟動平台的外掛程式登錄快取載入最佳化。 依預設,配置元素只有在需要時才會從登錄快取中載入(可以使用時),以減少記憶體覆蓋區。 這個選項可強迫在啟動時完全載入登錄快取。
eclipse.noRegistryCache {-noRegistryCache}
如果是 "true",既不會讀取、也不會寫入內部延伸登錄快取記憶體
eclipse.pluginCustomization {-pluginCustomization}
包含外掛程式喜好設定之預設值的內容檔之檔案系統位置。這些預設值會置換主要特性中指定的預設值。相對路徑被解譯為相對於 Eclipse 本身的現行工作目錄。
eclipse.product {-product}
將要執行的產品 ID。這用來控制各種品牌資訊以及使用哪個應用程式。
eclipse.service.jobs
控制 OSGi 服務的登錄。 設為 "false" 會暫停 org.eclipse.core.jobs 外掛程式登錄 OSGi 服務
eclipse.service.pref
控制 OSGi 服務的登錄。 設為 "false" 會暫停 org.eclipse.equinox.preferences 外掛程式登錄 OSGi 服務
eclipse.startTime
這個內容在啟動 Eclipse 時設定。這個內容的值是 System.currentTimeMillis() 所傳回之值的字串表示法。這個值不是要讓使用者設定的。
eclipse.stateSaveDelayInterval
持續保存狀態變更要求的延遲間隔(毫秒)。 預設值是 30000 ms(30 秒)。 狀態變更要求的延遲,是為了防止在執行管理作業(如安裝軟體組)時大量寫入磁碟。 延遲間隔用來等待一段在持續保存架構狀態資訊之前的不作用期間。
eclipse.vm {-vm}
用來執行 Eclipse 的 Java 執行檔的路徑。 這個資訊用來建構重新啟動指令行。
eclipse.vmargs {-vmargs}
列出用來執行 Eclipse 的 VM 引數。 這個資訊用來建構重新啟動指令行。
osgi.adaptor
要用的 OSGi 架構配接器的類別名稱。
osgi.arch {-arch}
請參閱 -arch
osgi.baseConfiguration.area
指定當未指定 osgi.configuration.area 時,所使用的基本配置。
osgi.bundlefile.limit
指定架構保持開啟的 JAR 檔數目限制。容許的最小值是 10。依預設,這個值是無限制。
osgi.bundles
在系統啟動和執行之後,會自動安裝和選擇性地啟動的逗點分隔的軟體組清單。 各項目的格式如下:
    <URL | simple bundle location>[@ [<start-level>] [":start"]]
如果省略啟動層次(>0 整數),架構會使用軟體組的預設啟動層次。 如果新增 "start" 標示,就會在安裝之後,將軟體組標示成已啟動。簡單軟體組位置會解譯成相對於架構的母目錄。 start-level 指示軟體組應該執行的 OSGi 啟動層次。 如果未設定這個值,系統會計算適當的預設值。
osgi.bundles.defaultStartLevel
這是 Eclipse Update 所安裝的所有軟體組都會設定的啟動層次。 osgi.bundles 清單所指定的軟體組可以指定特定啟動層次。 如果它們並未指定啟動層次,預設值便是 osgi.bundles.defaultStartLevel 的值。 osgi.bundles.defaultStartLevel 的預設值是 4。
osgi.clean
如果設定為 "true",任何使用 OSGi 架構以及 Eclipse 執行時期所快取的資料將會被清除。 這將會清除使用來儲存 軟體組相依關係與 Eclipse 延伸登錄資料的快取記憶體。使用此選項將會強迫 Eclipse 對這些快取記憶體進行重新初始化。
osgi.configuration.cascaded
如果設為 "true",這個配置會連鎖於母項配置。 母項配置由 osgi.sharedConfiguration.area 所指定。請參閱位置中的章節,以取得取得詳細資料。
osgi.configuration.area {-configuration}
這項平台作業的配置位置。 這個配置決定了將執行的外掛程式以及各個其他系統設定。 請參閱位置中的章節,以取得取得詳細資料。
osgi.configuration.area.default
這項平台作業的預設配置位置。 這個配置決定了將執行的外掛程式以及各個其他系統設定。 只有在未設定 osgi.configuration.area 的值時,才使用這個值(也就是預設值)。 請參閱位置中的章節,以取得取得詳細資料。
osgi.console {-console}
如果設成非空值,就會啟用 OSGi 主控台(如果已安裝的話)。 如果這個值是適當的整數,就會將它解譯成主控台用來接聽的埠,且會將它的輸出導向給定的埠。 非常適合用來探索系統的狀態。
osgi.console.class
要執行的主控台的類別名稱(如果要求的話)
osgi.console.encoding
如果設定的話,主控台編碼會使用指定的值(請參閱 osgi.console)。 如果未設定的話,會使用 file.encoding 內容值。 如果未設定 file.encoding,就會利用 iso8859-1 來作為預設值。
osgi.contextClassLoaderParent
用來作為「架構」所用的環境定義類別載入器之母項類別載入器的類別載入器類型。 有效類型如下:
osgi.debug {-debug}
如果設成非空值,平台就會進入除錯模式。 如果這個值是字串,就會將它解譯成 .options 檔的位置。 這個檔案指出哪些除錯點可供外掛程式使用,以及是否已經啟用。 如果未指定位置,平台會搜尋在安裝目錄下的 .options 檔。
osgi.dev {-dev}
如果設為空字串,就只會開啟 dev 模式。 這個內容也可以設成會加到各外掛程式之類別路徑中的逗點分隔類別路徑項目, 或設成包含一組外掛程式的自訂類別路徑新增項目之 Java 內容檔的 URL。 對於每個需要自訂 dev 時間類別路徑的外掛程式,這個檔案都會包含一個格式如下的項目:
    <plug-in id>=<comma separated list of classpath entries to add>
其中外掛程式 ID "*" 符合任何未在其他情況下提及的外掛程式。
osgi.filepermissions.command
指定選用的 OS 專屬指令來設定擷取的原生程式碼之檔案許可權。 在某些作業系統上,原生程式庫必須設為執行檔。 這個選用的內容可讓您指定指令。 例如,在 UNIX 樣式的 OS 上,您可能會有下列值:
    osgi.filepermissions.command="chmod +rx [fullpath]"
架構利用 [fullpath] 來替代實際的檔案路徑。
osgi.framework
OSGi 架構的 URL 位置。如果 Eclipse 安裝是分離的,就非常有用。請參閱位置中的章節,以取得取得詳細資料。
osgi.frameworkClassPath
OSGi 架構實作的逗點分隔的類別路徑項目清單。相對位置會相對於架構位置(請參閱 osgi.framework)來解譯
osgi.framework.extensions
以逗點區隔的架構延伸清單。各項目的格式如下:
    <簡式軟體組位置>
簡式軟體組位置是在 org.eclipse.osgi bundle 的母項目錄中搜尋的。 您可以使用架構延伸來執行具有不同架構配接器的 Eclipse。架構延伸可包含 eclipse.properties 檔,以設定系統內容。例如,提供架構配接器實作的架構延伸可藉由設定 osgi.adaptor 內容的方法,來設定配接器的類別。
osgi.framework.shape
設為「Eclipse OSGi 架構」實作的形狀。這個內容是在啟動 Eclipse 平台時設定,而且不是要讓使用者設定的。"jar" 值指出「Eclipse OSGi 架構」內含在單一 JAR 中。"folder" 值指出「Eclipse OSGi 架構」內含在目錄中。
osgi.framework.library.extensions
其他必須搜尋的程式庫副檔名清單(用逗點分隔)。 如果未設定,便會利用 System.mapLibraryName(String) 傳回的程式庫名稱來進行搜尋。 某些容許程式庫有多個副檔名的作業系統會需要這個項目。 例如,AIX 便接受程式庫副檔名 .a 和 .so,但 System.mapLibraryName(String) 只會傳回副檔名是 .a 的名稱。
osgi.framework.useSystemProperties
控制架構內容是受到廣域系統內容的支持,或針對每個架構實例而保留專用。 依預設,架構內容是受到系統內容的支持(如 true)。 當在相同 VM 內執行「OSGi 架構」的多個實例,且每個實例都有個別的一組配置內容(例如,設在 config.ini 中)時,這個內容非常有用。
osgi.genericAliases
可用來將現有的 Manifest 標頭對映至 Eclipse-GenericCapability 和 Eclipse-GenericRequire Manifest 標頭一般的別名清單(用逗點分隔)。 osgi.genericAliases 內容使用下列語法:
  osgi.genericAliases ::= generic-alias ( ',' generic-alias ) *
  generic-alias       ::= capability-alias ':' require-alias ':' capability-type
比方說,如果要將 OSGi 標頭 Export-Service 和 Import-Service 標頭對映至 Eclipse-GenericCapability 和 Eclipse-GenericRequire 標頭,您會使用下列值:
  osgi.genericAliases=Export-Service:Import-Service:osgi.service
osgi.hook.configurators
連結鉤配置器的清單(用逗點分隔)。 如果設定了這個內容,所用的配置器一律在指定的配置器清單內。 將忽略 hookconfigurators.properties 檔所指定的任何連結鉤配置器。
osgi.hook.configurators.include
其他連結鉤配置器的清單(用逗點分隔)。 在配置選用的連結鉤配置器時,這很有用。 如果使用 osgi.hook.configurators 選項,會忽略這個選項。
osgi.hook.configurators.exclude
要排除的連結鉤配置器的清單(用逗點分隔)。 在停用連結鉤配置器內容檔所指定的連結鉤配置器時,這很有用。 如果使用 osgi.hook.configurators 選項,會忽略這個選項。
osgi.java.profile
要使用的 JRE 設定檔 URL。指定的 URL 會當作 Java 內容檔來讀取。 JRE 設定檔包含 org.osgi.framework.system.packages、org.osgi.framework.bootdelegation 和 org.osgi.framework.executionenvironment 等內容的值。 如果未設定 osgi.java.profile,則會依據執行中 JRE 的 java.specification.version 值,來選取設定檔。
osgi.java.profile.bootdelegation
Java 設定檔 osgi.java.profile 可能包含 "org.osgi.framework.bootdelegation" 內容。這個值可用來設定系統內容 "org.osgi.framework.bootdelegation"。osgi.java.profile.bootdelegation 指出要使用的 bootdelegation 原則。下列值是有效值(預設值是 ignore):
osgi.install.area {-install}
平台的安裝位置。這個設定指示基本 Eclipse 外掛程式的位置,如果 Eclipse 安裝是分離的,就非常有用。 請參閱位置中的章節,以取得取得詳細資料。
osgi.instance.area {-data}
這個階段作業的實例資料位置。外掛程式使用這個位置來儲存其資料。 比方說,資源外掛程式會使用這個作為專案的預設位置(如:工作區)。請參閱位置中的章節,以取得取得詳細資料。
osgi.instance.area.default
這個階段作業的預設實例資料位置。外掛程式使用這個位置來儲存其資料。 比方說,資源外掛程式會使用這個作為專案的預設位置(如:工作區)。只有在未設定 osgi.instance.area 的值時,才使用這個值(也就是預設值)。 請參閱位置中的章節,以取得取得詳細資料。
osgi.locking
針對這項平台作業而使用的鎖定類型。有效的鎖定類型是 "java.io"、"java.nio" 和 "none"。預設值是 "java.nio";除非 JRE 不支援 "java.nio",否則 "java.io" 為預設值。
osgi.manifest.cache
探索和產生產生 Manifest 的位置。 預設值是在配置區中,但 Manifest 快取可以個別儲存。
osgi.nl {-nl}
Eclipse 平台所執行的語言環境名稱。 NL 值應該遵循標準 Java 語言環境命名慣例。
osgi.nl.user
當使用者將 -nl 明確加到指令行引數時的語言環境名稱。
osgi.noShutdown {-noExit}
如果是 "true",則在 Eclipse 應用程式結束後,VM 便不會存在。這有助於在 Eclipse 應用程式結束後, 檢查 OSGi 架構。
osgi.os {-os}
作業系統值。這個值應該是 Eclipse(如 x86、sparc...)所認得的 Eclipse 處理器架構名稱之一。
osgi.parentClassloader
對於已安裝在「架構」中的所有軟體組,要當作母項類別載入器使用的類別載入器類型。有效類型如下:
osgi.requiredJavaVersion
啟動 Eclipse 所需的最低 Java 版本需求。預設值是 "1.4.1"。
osgi.resolverMode
用來解析已安裝在「架構」中之軟體組的模式。"strict" 值將解析器置於嚴格模式。預設的解析器模式不是嚴格。解析器處於嚴格模式時, 若從指定 x-internal 或 x-friends 指引的已匯出套件中,載入類別和資源,則「架構」會強迫存取限制規則。
osgi.sharedConfiguration.area
這項平台作業的共用配置位置。如果 osgi.configuration.cascaded 內容設為 "true",則共用配置區會當成母項配置使用。
osgi.splashLocation
啟動 Eclipse 時所顯示的歡迎畫面(.bmp 檔)的絕對 URL 位置。 這個內容會置換 osgi.splashPath 中設定的值。
osgi.splashPath
在其中搜尋 splash.bmp 檔的逗點分隔的 URL 清單。 這個內容被 osgi.splashLocation 中設定的值所置換。
osgi.startLevel
在啟動時,架構將設定的啟動層次值。預設值是 6。
osgi.support.signature.verify
有效值是 "true" 或 "false",預設值是 "false"。當設為 "true" 時,架構會從簽章 JAR 中載入憑證,且會在執行時期確認內容並未毀損。
osgi.syspath
設為「Eclipsee OSGi 架構」(org.eclipse.osgi) 實作所在的路徑。例如,"<eclipse install path>/eclipse/plugins"。這個內容是在啟動 Eclipse 平台時設定,而且不是要讓使用者設定的。
osgi.user.area {-user}
使用者區域的位置。使用者區域包含 OS 使用者專用且獨立於 Eclipse 安裝、配置或實例之外的資料(如喜好設定)。 請參閱位置中的章節,以取得取得詳細資料。
osgi.user.area.default
使用者區域的預設位置。使用者區域包含 OS 使用者專用且獨立於 Eclipse 安裝、配置或實例之外的資料(如喜好設定)。 只有在未設定 osgi.user.area 的值時,才使用這個值(也就是預設值)。 請參閱位置中的章節,以取得取得詳細資料。
osgi.ws {-ws}
視窗系統值。這個值應該是 Eclipse(如 win32、motif...)所認得的 Eclipse 視窗系統名稱之一。

位置

Eclipse 執行時期定義若干位置,為外掛程式開發人員提供了讀取/儲存資料的環境定義, 為 Eclipse 使用者提供了對於資料之共用和可見性範圍的控制。 Eclipse 定義下列位置記號:

使用者 (-user) {osgi.user.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
使用者位置是執行圖例使用者所專用的。 使用者位置通常是以 Java user.home 系統內容值為基礎,但可予以置換。 您可以在使用者位置中,找到使用者範圍喜好設定和登入資訊之類的資訊。
安裝 (-install) {osgi.install.area} [@user.home, @user.dir, filepath, url]
安裝位置是 Eclipse 本身的安裝位置。 實際上,這個位置是所執行的 startup.jar 或 eclipse.exe 的母項目錄(通常是 "eclipse")。 對一般使用者而言,這個位置應該視為唯讀,因為安裝可由許多使用者來共用。 您可以設定安裝位置,再分離 startup.jar 和 Eclipse 的其餘部分。
配置 (-configuration) {osgi.configuration.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
配置位置包含用來識別和管理要執行的安裝(子)集的檔案。 就此而言,每項安裝都可能有許多配置。 安裝可能會檢附預設配置區,但一般啟動實務所涉及的執行時期會試圖尋找比較能夠寫入的配置位置。
實例 (-data) {osgi.instance.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
實例位置包含使用者定義的資料構件。 比方說,資源外掛程式會利用實例區來作為工作區位置,因而成為專案的預設起始位置。 其他外掛程式可以在這個位置自由寫入它們想寫入的任何檔案。

使用者可以設定任何這些位置,如果沒有提供值的話,Eclipse 會計算合理的預設值。 設定位置最常見的使用個案是實例區,在 IDE 環境定義中,則是工作區。 如果要在特定資料集上執行預設 Eclipse 配置,您可以指定:

    eclipse -data c:\mydata

其他詳細資料

位置是 URL。為了簡單,檔案路徑也可以接受,它會自動轉換成 file: URL。 為了更方便及更好控制,您也可以使用許多預先定義的符號位置。 請注意,並非位置類型和符號值的所有組合都有效。 下表詳細說明可能的組合。 由於預設情況是針對所有要設定的有效和可寫入的位置,部分外掛程式在其他設定中可能會失敗,即使它們列為可能的,也是如此。 比方說,如果未定義實例區,期待焦點在使用者資料的外掛程式(如 Eclipse 資源外掛程式)去執行太多動作並不合理。 外掛程式開發人員必須負責選擇他們所支援的設定,並據此來設計其功能。

@none
表示絕不應設定對應的位置,不論是明確設定或設為預設值,都是如此。 比方說,沒有使用者資料的 RCP 樣式應用程式可以利用 osgi.instance.area=@none 來防止將無關的檔案寫入磁碟中。 @none 後面不能接著任何附加的路徑區段。
@noDefault
強制取消定義或明確定義某個位置(也就是說,Eclipse 不自動計算預設值)。 當您要接受對應位置中的資料,但 Eclipse 預設值並不適合時,這就很有用。 @noDefault 後面不能接著任何附加的路徑區段。
@user.home
引導 Eclipse 相對於使用者的起始目錄來計算位置值。 @user.home 後面可以接著附加的路徑區段。 在所有情況中,"@user.home" 字串都會簡單地用 Java "user.home" 系統內容來取代。 比方說,設定
    osgi.instance.area=@user.home/myWorkspace
會產生下列值:
    file:/users/bob/myWorkspace
@user.dir
引導 Eclipse 相對於現行工作目錄來計算位置值。 @user.dir 後面可以接著附加的路徑區段。 在所有情況中,"@user.dir" 字串都會簡單地用 Java "user.dir" 系統內容來取代。 比方說,設定
    osgi.instance.area=@user.dir/myWorkspace
會產生下列值:
    file:/usr/share/eclipse/myWorkspace
位置/值
支援預設值
檔案/URL
@none
@noDefault
@user.home
@user.dir
instance
yes
yes
yes
yes
yes
yes(預設值)
configuration
yes
yes
yes*
yes*
yes
yes
install
no
yes
no
no
yes
yes
user
yes
yes
yes
yes
yes
yes

* 表示這個設定在技術上可能,但實際上很難管理。 特別是在沒有配置位置時,Eclipse 執行時期可能只會做到啟動 OSGi 架構。

唯讀位置

您可藉由附加 ".readOnly" 到位置內容,並將它設為 "true" 值,來將位置指定為唯讀位置。下列內容可用來 將其相對應的位置指定為唯讀:

啟動程式 ini 檔案

現在,eclipse.exe 和 RCP 應用程式較常用的執行檔從相關的 inii 檔案來讀取參數。這個檔案提供獨立式平台來傳入先前必須直接在指令行中指定的引數(例如 vm 或 vm 引數)。 雖然可以在這個檔案中指定所有參數,但為了各種安裝的可維護性和一致性,建議您在這個 ini 檔案中只要指定 vm 位置和 vm 引數,其他的則使用 config.ini 檔。

檔案格式

此檔案必須以執行檔名稱來命名(例如,eclipse.exe 會讀成 eclipse.ini,而 launcher.exe 則讀成 launcher.ini),且必須在檔案的換行中指定每個參數。以下是指定 vm 位置和部分參數的檔案範例:

-vm
c:/myVm/java.exe
-vmargs
-Dms40M