執行 Eclipse

將 Eclipse SDK 安裝到某個目錄之後,您可以執行版本所附的 Eclipse 執行檔來啟動工作台(您也需要 1.4.2 JRE,未併在 Eclipse SDK 中)。 在 Windows 中,這個執行檔稱為 eclipse.exe,在安裝的 eclipse 子目錄中。 如果是安裝在 c:\eclipse-SDK-3.2-win32,這個執行檔便是 c:\eclipse-SDK-3.2-win32\eclipse\eclipse.exe附註:大部分其他作業環境中的設定也都類似。 以下列出 Mac OS X 的特殊指令。

配置足夠的記憶體及解決 OutOfMemoryErrors

依預設,Eclipse 會配置最多 256 MB 的 Java 資料堆記憶體。 對所有一般開發工作而言,這應該足夠。 不過,依您在執行的 JRE、您在使用的其他外掛程式的數目及您將使用的檔案數目而定,相信您有可能需要增加這個量。 Eclipse 可讓您利用 -vmargs 指令行引數,將引數直接傳給 Java VM。這些指令行引數必須在所有其他 Eclipse 專用引數之後。 因此,如果要增加可用的資料堆記憶體,您通常會使用:

eclipse -vmargs -Xmx<memory size>

<memory size> 值設為大於 "256M"(256 MB - 預設值)。

當使用 Sun VM 時,您也可能需要增加永久世代記憶體的大小。 預設值上限是 64 MB,依外掛程式配置和使用情況而定,也許需要更多。 永久世代大小上限是利用 -XX:MaxPermSize=<memory size> 引數來增加的:

eclipse -vmargs -XX:MaxPermSize=<memory size>

這個引數可能無法供所有 VM 版本和平台使用;請參閱 VM 文件,以取得詳細資料。

請注意,將記憶體大小設成大於可用實體記憶體的數量,會使 Java「翻跳扭動」,因為它會反覆將物件複製到虛擬記憶體,又複製回來,效能會嚴重退化。

選取工作區

當工作台啟動時,首先會出現一個對話框,讓您選擇工作區將放在哪裡。 工作區是將用來儲存您的工作的目錄。 如果您並未指定,Eclipse 會將工作區建在您的使用者目錄中。 這個工作區目錄是用來作為專案的預設內容區域, 它也會用來保留任何所需要的 Meta 資料。如果是共用或多工作區安裝,您必須利用對話框(或利用 "-data" 指令行引數)來明確指定工作區的位置。

典型的 Eclipse 指令行如下: 

eclipse -vm c:\jdk1.4.2\jre\bin\javaw

提示:建議您指明在執行 Eclipse 時,要使用哪一個 Java VM。這是依照上述說明,利用 "-vm" 指令行引數來完成的。 如果您沒有使用 "-vm",Eclipse 會查看 O/S 路徑。 當您安裝其他 Java 型產品時,它們可能會變更您的路徑,當您下次啟動 Eclipse 時,可能會使用另一個 Java VM。

如果要建立通往已安裝之 Eclipse 的 Windows 捷徑,請執行下列動作:

  1. 在「Windows 檔案總管」中,導覽至 eclipse.exe,使用內容功能表中的「建立捷徑」。
  2. 選取捷徑,編輯它的內容。 在「目標:」中,附加指令行引數。

開啟這個捷徑會啟動 Eclipse。 (如果您想要很容易存取捷徑,您可以將捷徑拖曳到 Windows 桌面。)

Mac OS X

在 Mac OS X 中,您是按兩下 Eclipse 應用程式來啟動 Eclipse。 如果您需要將引數傳給 Eclipse,您必須在 Eclipse 應用程式軟體組內編輯 eclipse.ini 檔:請按住 Ctrl 鍵來選取 Eclipse 應用程式軟體組圖示。 這會呈現一個蹦現功能表。 請選取蹦現功能表中的"顯示套件內容"。 在 Contents/MacOS 子資料夾中尋找 eclipse.ini 檔,利用偏好的文字編輯器來開啟它,以編輯指令行選項。

如果您需要從指令行啟動 Eclipse,您可以在最上層 Eclipse 資料夾中使用符號鏈結 "eclipse"。 它會參照應用程式軟體組內的 Eclipse 執行檔,且會採用其他平台的 "eclipse.exe" 的相同引數。

在 Mac OS X 10.4 和後來的版本上,您可能會發現,如果您容許「聚焦建立工作區索引」,當使用大量資源時,速度會變慢。 如果要防止這個情況,請啟動「系統喜好設定」,選取「聚光燈」圖示,再選取「私密性」標籤,再按一下「新增」按鈕 ("+"),在出現的對話框中尋找您的工作區目錄。

共用安裝

如果共用安裝區儲存了適當的快取資訊,可能會改進共用安裝的啟動速度。 如果要做到這一點,請在 Eclipse 發行套件解壓縮之後,從有安裝目錄寫入權的帳戶,利用 "-initialize" 選項來執行一次 Eclipse。

執行 Eclipse 的進階主題

Eclipse 執行檔和平台本身提供了一些對負責開發和除錯 Eclipse 各組件的人非常有用的執行選項。 這是一份常用選項的清單,如果需要完整清單,請參閱「平台外掛程式開發人員手冊」中的「Eclipse 執行時期選項」頁面。 Eclipse 執行檔的一般執行形式如下:

eclipse [platform options] [-vmargs [Java VM arguments]]
Eclipse 啟動參數
指令 說明
-arch architecture
定義 Eclipse 平台在其上執行的處理器架構。Eclipse 平台通常使用 Java os.arch 內容的通行值來計算最佳設定。如果在這裡指定,則這是 Eclipse 平台使用的值。這裡指定的值可供外掛程式以 BootLoader.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 configurationFileURL
「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 平台使用的值。這裡指定的值可供外掛程式以 BootLoader.getNL() 使用。 範例值:"en_US" 和 "fr_FR_EURO"。 2.0
-nosplash
執行平台,但不顯示歡迎畫面。 1.0
-os operatingSystem
定義 Eclipse 平台在其上執行的作業系統。Eclipse 平台通常使用 Java os.name 內容的通行值來計算最佳設定。如果在這裡指定,則這是 Eclipse 平台使用的值。這裡指定的值可供外掛程式以 BootLoader.getOS() 使用, 並用來解析在外掛程式 manifest 檔中提及的路徑中出現的 $os$ 變數。範例值:"win32"、"linux"、 "hpux"、"solaris"、"aix"。 1.0
-password password
授權資料庫的密碼。與 -keyring 選項一起使用。 1.0
-perspective perspectiveId
啟動時要在作用中的工作台視窗開啟的視景。如果沒有指定這個參數, 就會開啟之前關機時正在作用的視景。 1.0
-plugincustomization
	  propertiesFile
包含外掛程式喜好設定之預設值的內容檔之位置。這些預設值會置換主要特性中指定的預設值。相對路徑被解譯為相對於 eclipse 從中啟動的目錄。 2.0
-product productId
要執行的產品 ID。 這個產品為 Eclipse 的啟動實例帶來了特色,決定了所用的產品自訂資訊。 這用來取代 -feature,但為了相容,目前仍支援 -feature。 3.0
-refresh 
選擇在啟動時執行工作區的整體自動更新的整項。這樣可以使在前次執行平台之後對檔案系統所作的任何變更一致。 1.0
-showlocation [workspaceName]
選擇在視窗標題列中顯示工作區的位置的選項。在版本 2.0 中,這個選項只能和 -data 指令行引數一起使用。在 3.2 中,新增了選用的工作區名稱引數,它會將提供的名稱顯示在視窗標題列中,而不是顯示在工作區的位置。 2.0
-vm vmPath
用來執行 Eclipse 平台之 Java Runtime Environment (JRE) 的位置。如果未指定,則 JRE 在 Eclipse 執行檔的同屬目錄 jre。相對路徑被解譯為相對於 eclipse 從中啟動的目錄。 1.0
-vmargs args
當傳給 Eclipse 時,這個選項用來自訂執行 Eclipse 時所用的 Java VM 作業。 如果指定的話,這個選項必須在指令行的尾端。 給定的引數會隨著所執行的 VM 而不同。 1.0

在 -vmargs 項目之後的所有引數(不包括這個項目)都會作為虛擬機器引數來直接傳遞給所指示的 Java VM(就是在執行類別之前)。附註:如果 Eclipse 啟動引數(例如 -data)是在 Java vm 引數 (-vmargs) 之後提供,Eclipse 就無法啟動,而且您會收到 "JVM 終止。結束碼=1" 的錯誤。