當使用主要特性機制時,產品自訂的運作方式會不同。特性的品牌資訊位於主要特性所識別的外掛程式中(如果未指定,是位於與主要特性相同名稱的外掛程式中)。針對我們假定的 acmeweb 應用程式指派和定義品牌資訊的檔案, 都在下列範例目錄結構中強調顯示出來:
acmeweb/ acmeweb.exe (產品執行檔 - 呼叫 eclipse.exe 並指定主要特性) eclipse/ .eclipseproduct eclipse.exe startup.jar install.ini .config/ platform.cfg jre/ features/ com.example.acme.acmefeature_1.0.0/ (主要特性) feature.xml plugins/ com.example.acme.acmefeature_1.0.0/ (主要特性的外掛程式。含有品牌行銷資訊。) plugin.xml about.ini about.html about.mappings about.properties acme.png plugin_customization.ini splash.jpg welcome.xml com.example.acme.acmewebsupport_1.0.0/ ... links/ ...
您可以在主要功能相關外掛程式中指定產品的品牌資訊。產品有許多可自訂的方向。產品層次自訂作業使用 about.ini 檔以及其他檔案來定義。產品也可控制其他外掛程式的預設喜好設定值。plugin_customization.ini 檔可完成這個工作。
請再參照範例產品的主要特性外掛程式;讓我們更仔細瞭解如何自訂產品。
com.example.acme.acmefeature_1.0.0/ plugin.xml about.ini about.html about.mappings about.properties acme.png plugin_customization.ini plugin_customization.properties splash.bmp welcome.xml
我們將檢視對產品延伸點所檢視的相同自訂,著重在使用主要特性機制時的規格會有哪些不同。
在討論產品層次的自訂時,所有的特性和外掛程式應該提供 about.html 檔來提供特定外掛程式的相關資訊。
主要特性也為整體產品提供資訊和圖形。其他檔案也用來指定這個資訊。
16x16 像素彩色影像可用來在產品所建立的視窗顯示商標。它將顯示在產品視窗的左上角。 about.ini 檔中的 windowImage 屬性會指定這個影像。 路徑應指定為外掛程式的相對路徑。 以下為適用於以上目錄結構的項目:
windowImage=acme.png
使用「Eclipse 2.1 歡迎使用」機制的外掛程式應該在 about.ini 檔的 welcomePage 屬性指定歡迎使用頁面檔。該路徑應該指定成外掛程式相對路徑。 以下為適用於以上目錄結構的項目:
welcomePage=welcome.xml
您也可以為檔案指定國家語言的查閱。(請參閱語言環境特定的檔案以取得詳細資料。)
welcomePage=$nl$/welcome.xml
產品歡迎畫面由位於主要特性外掛程式中的 splash.bmp 檔所提供。所提供的影像為 24 位元 色彩 BMP 格式(RGB 格式)檔案,而大小約為 500x330 圖素。如果需要為不同的語言環境自訂歡迎畫面,可將這些檔案放置到主要特性外掛程式的片段中。
plugin_customization.ini 檔是用來為其他外掛程式定義喜好設定預設值的喜好設定值。檔案格式為 java.io.Properties。 這個檔案一般用來設定外掛程式 public API 的喜好設定檔。也就是如果您參照外掛程式所使用的喜好設定但未正式定義在 API 中,就會造成風險。
共用自訂作業是為工作台設定預設的視景。這個喜好設定定義在 org.eclipse.ui 外掛程式中。 下列範例假設產品應該使用資源視景作為預設視景來啟動。
org.eclipse.ui/defaultPerspectiveId=org.eclipse.ui.resourcePerspective
如果您發現需要為另一個外掛程式的喜好設定變更預設值,請參閱外掛程式 API 文件以瞭解喜好設定是否被考量為 public。
plugin_customization.properties 檔包含為 plugin_customization.ini 檔案轉換的字串。