從 3.4 版開始,Eclipse 提供個別的原始檔軟體組,可進行更靈活的原始檔遞送。 請參閱「個別原始檔軟體組」頁面,以取得詳細資料。 您仍可以依照下列概述來建置傳統資料夾式的原始檔外掛程式。
請考量下列 SDK 特性:
features/
org.foo.sdk/
feature.xml: <includes id="org.foo.rcp" />
<includes id="org.foo.rcp.source" />
build.properties: generate.feature@org.foo.rcp.source = org.foo.rcp
org.foo.rcp/
feature.xml: <plugin id="org.foo.BundleA" />
<plugin id="org.foo.BundleB" />
<plugin id="org.foo.BundleB.win32" fragment="true" os="win32" />
SDK 的觀念在於,它既併入了特性,也併入了這個特性的來源。 請注意特性 build.properties 檔中的 generate.feature 內容。 這個內容告訴「PDE 建置」根據 "org.foo.rcp" 特性的內容來產生名稱為 "org.foo.rcp.source" 的特性。PDE 建置會產生一個 org.foo.rcp.source 特性、一個將含有原始碼的外掛程式,以及若干片段,其中含有任何已併入特性之特定平台專用軟體組的來源:
features/
org.foo.rcp.source/
feature.xml: <plugin id="org.foo.rcp.source"/>
<plugin id="org.foo.rcp.source.win32" fragment="true" os="win32" />
plugins/
org.foo.rcp.source/src/
org.foo.BundleA/src.zip
org.foo.BundleB/src.zip
org.foo.rcp.source.win32/src/
org.foo.BundleB.win32/src.zip
generate.feature 內容的格式如下:
generate.feature@<source feature id> = <feature id> [, feature@<feature id>[;attribute=value]*]* [, plugin@<plugin id>[;attribute=value]*]*
請利用 plugin@,將不屬於原始特性的其他外掛程式加到產生的來源特性中。 對於文件外掛程式而言,這很有用。feature@ 與來源範本合起來,可用來巢狀安排來源特性(請參閱下文)。
產生來源特性的特性可以提供一些將併到產生之來源特性中的範本檔:
features/
org.foo.rcp/
sourceTemplateFeature/<files to be included in generated source feature>
sourceTemplatePlugin/<files to be included in generated source plugin>
sourceTemplateFragment/<files to be included in generated platform specific fragments>
在這些 sourceTemplate 資料夾中的任何檔案都會併在適當產生的特性/外掛程式/片段中。 明確地說,這些目錄的檔案會取代 PDE 建置所產生的檔案。 如果來源特性有 PDE 建置不支援的需求,便可以利用這個方式來提供自訂的 feature.xml。
您可以提供產生的來源特性之 sourceTemplateFeature/build.properties 檔,其中含有巢狀來源特性的 generate.feature 內容,以便用巢狀方式來安排來源特性。
另外,您也必須確保最上層的來源 feature.xml 包含巢狀來源特性,請利用 feature@ 或提供範本 feature.xml 來做到這一點:
features/
org.foo.sdk/
sourceTemplateFeature/
build.properties: generate.feature@org.foo.nested.source = org.foo.nested
feature.xml: <includes id="org.foo.rcp" />
<includes id="org.foo.rcp.source" />
build.properties: generate.feature@org.foo.rcp.source = org.foo.rcp, feature@org.foo.nested.source
org.foo.rcp/...
org.foo.nested/...
其也可能根據特性來產生單一原始檔外掛程式,而非產生完整的原始檔特性。執行這個動作的內容是:
generate.plugin@<source plug-in id>=<feature-in id>
請注意,這些舊式原始檔外掛程式(一個外掛程式就含有該特性之所有外掛程式的原始檔)必須以資料夾的形式來安裝。 因此,您必須在 feature.xml 檔中設定 unpack="true" 屬性。
範例:features/
org.foo.sdk/
feature.xml: <plugin id="org.foo.rcp" />
<plugin id="org.foo.sdk.source" unpack="true" />
build.properties: generate.plugin@org.foo.sdk.source = org.foo.sdk