來源軟體組是根據其資訊清單中含有 Eclipse-SourceBundle 標頭來加以識別。這個標頭的格式如下:
Eclipse-SourceBundle: <bundle-id>;version=<version>;roots:="root1, root2"
bundle-id 和 version 表示內含的程式碼所對應的軟體組。roots 指引表示實際包含程式碼之來源軟體組內的資料夾。如果未指定 roots 指引,則會採用 "." 的值。
類別檔程式庫會以可預測的方式,對映至來源位置。外掛程式的根目錄會對映至來源軟體組的根目錄。這是大部分封裝成 JAR 之外掛程式的主要情況。如果外掛程式包含其他程式庫 "foo/lib.jar",程式碼會預期放在來源軟體組對應的 "foo/libsrc/" 資料夾中。
org.eclipse.pde.core.jar org.eclipse.pde.core.source.jar - org/**/*.class - org/**/*.java - ant_tasks/pde-ant.jar - ant_tasks/pde-antsrc/org/**/*.java
Eclipse-SourceBundle: org.eclipse.pde.core;version="3.4.0.N20071128-0010";roots:="ant_tasks/pde-antsrc,."
org.eclipse.pde.build/ org.eclipse.pde.build.source.jar - pdebuild.jar - pdebuildsrc/org/**/*.java - lib/pdebuild-ant.jar - lib/pdebuild-antsrc/org/**/*.java
Eclipse-SourceBundle: org.eclipse.pde.build;version="3.4.0.N20071128-0010";roots:="pdebuildsrc,lib/pdebuild-antsrc"
「PDE/建置」可以自動產生個別來源軟體組,但只限於遠端控制建置。您可以指定下列項目,來開啟產生個別來源軟體組:
individualSourceBundles=true
這必須指定在建置配置的最上層 build.properties 檔中,其會控制該建置所有產生程式碼的作業。請參閱產生來源特性和外掛程式,以取得產生傳統來源外掛程式和特性的詳細資料;這個頁面的其餘內容會假設您熟悉傳統的產生程式碼作業。
generate.feature@<source feature id> = <feature id> [, feature@<feature id>]* [, plugin@<plugin id>]* [, exclude@<plugin id>]*
在產生個別來源軟體組時,這個內容會像以前一樣保留,並支援相同的屬性(例如:version、unpack、optional 等等),而差異會記載在產生的來源特性中。以前,來源特性對每一個要建置的平台都會包括 1 個來源外掛程式 + 一個程式碼片段。在新的格式中,來源特性會對原始特性中列出的每一個外掛程式/片段,包括一個來源軟體組。
透過 plugin@ 語法包含在來源特性中的外掛程式,不會有對應的來源軟體組。這對於將文件外掛程式加入來源特性中非常有用。
exclude@ 項目是用於產生個別程式碼的新項目。併入起始特性的某些外掛程式(亦即,只含原生程式碼的文件外掛程式或片段)可能沒有程式碼,而應該從產生的來源特性中排除。exclude@ 項目支援 version 屬性。
範例:generate.feature@org.eclipse.jdt.source=org.eclipse.jdt, plugin@org.eclipse.jdt.doc.isv;unpack="false",exclude@org.eclipse.jdt.doc.user
在舊的格式中,generate.plugin 內容會根據給定特性的內容來產生來源外掛程式。在產生個別來源軟體組時,這會根據給定的外掛程式來變更:
generate.plugin@<source plug-in id>=<plug-in id>
過去特性會使用 generate.plugin 內容來併入程式碼,而不具有來源特性(即使幕後已產生完整的來源特性)。在產生個別來源軟體組時,特性需要包括每一個外掛程式的 *.source 軟體組,以及每一個項目對應的 generate.plugin 內容。
範例:sdk.examples 特性通常看起來如下:
<feature id="org.eclipse.sdk.examples" ... > .... <plugin id="org.eclipse.sdk.examples.source" version="0.0.0"/> <plugin id="org.eclipse.sdk.examples.source.win32.win32.x86" version="0.0.0"/> </feature>
generate.plugin@org.eclipse.sdk.examples.source=org.eclipse.sdk.examples
這會變更為:
<feature id="org.eclipse.sdk.examples" ...> ... <plugin id="org.eclipse.compare.examples.source" version="0.0.0"/> <plugin id="org.eclipse.debug.examples.core.source" version="0.0.0"/> <plugin id="org.eclipse.swt.examples.source" version="0.0.0"/> </feature>
generate.plugin@org.eclipse.compare.examples.source=org.eclipse.compare.examples generate.plugin@org.eclipse.debug.examples.core.source=org.eclipse.debug.examples.core generate.plugin@org.eclipse.swt.examples.source=org.eclipse.swt.examples
特定的外掛程式可能不需要來源軟體組,因為其並未實際包含程式碼。這可能會發生在只含原生程式庫的平台專用片段。在此情況下,您可以如上方 generate.feature 所述,由特性來排除軟體組。
或者,軟體組可以在其自己的 build.properties 檔中,明確指定不應產生任何來源軟體組:
generateSourceBundle=false
自訂內容一律可以在起始軟體組中使用 post.gather.source 自訂回呼,來加入產生的來源軟體組中。(請參閱特性和外掛程式的自訂建置步驟)。
在執行這項作業時,請在外掛程式的 build.properties 檔中設定 "src.additionalRoots" 內容,使得產生來源軟體組在 Eclipse-SourceBundle 標頭中有正確的 roots 指引。
範例:
org.junit4 :
build.properties
src.includes = about.html,junitsrc.zip
src.additionalRoots=junitsrc
customBuildCallbacks=customBuildCallbacks.xml
customBuildCallbacks.xml
<target name="post.gather.sources" >
<mkdir dir="${target.folder}/junitsrc"/>
<unzip src="${target.folder}/junitsrc.zip" dest="${target.folder}/junitsrc" overwrite="false"/>
<delete file="${destination.temp.folder}/junitsrc.zip" />
</target>
之前,產生的來源外掛程式會用來作為產生之來源特性的品牌形象外掛程式。品牌行銷檔(about.properties、eclipse32.gif 等等)過去是利用原始特性中的 sourceTemplatePlugin 目錄來提供。
在產生個別來源軟體組時,來源特性的品牌形象外掛程式會是對應於原始品牌形象外掛程式的來源軟體組。這表示來源特性之品牌形象外掛程式的品牌行銷檔,可以利用原始品牌形象外掛程式中的 src.includes 內容來提供。
要產生其程式碼之特性的 sourceTemplatePlugin 資料夾,也會提供檔案給品牌形象外掛程式。
之前,原始特性之 sourceTemplatePlugin 目錄的內容會複製到來源外掛程式中。在產生個別來源軟體組時,只有品牌行銷來源軟體組才會依然是如此(請參閱上述說明)。
對所有其他來源軟體組而言,則會複製 sourceTemplateBundle 目錄的內容。