Egy forrásköteget a köteg leírófájljában szereplő Eclipse-SourceBundle fejléc azonosít. A fejléc formátuma:
Eclipse-SourceBundle: <köteg_azonosító>;version=<verziószám>;roots:="root1, root2"
A köteg azonosítója és verziószáma jelzi, hogy a tartalmazott forrás mely kötegnek felel meg. A roots direktíva jelöli a forráskötegen belüli mappákat, amelyek valójában a forráskódot tartalmazzák. Ha nincs megadva roots direktíva, akkor a rendszer a "." értéket feltételezi.
Az osztályfájl függvénytárak egy előre kiszámítható módon vannak leképezve a forrás helyekre. A bedolgozó gyökere a forrásköteg gyökerére van leképezve. A legtöbb JAR fájlba csomagolt bedolgozó esetében ez a helyzet. Ha a bedolgozó további "foo/lib.jar" függvénytárakat tartalmaz, akkor a forráskötegben ezek valószínűleg a megfelelő "foo/libsrc/" mappákban lesznek.
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"
A PDE összeépítés bedolgozó automatikusan létre tudja hozni az egyéni forráskötegeket, de csak egy megjelenítés nélküli összeépítésben. Az egyéni forráskötegek előállítása a következő tulajdonság megadásával kapcsolható be:
individualSourceBundles=true
Ezt az összeépítési konfiguráció felső szintű build.properties fájljában kell megadni, és ez fogja vezérelni a forrás előállítását az adott összépítéshez. A hagyományos forrás bedolgozók és szolgáltatások előállításával kapcsolatos részletekért tekintse meg a Forrás szolgáltatások és bedolgozók előállítása című részt. Az oldalon található összefoglaló feltételez némi jártasságot a források hagyományos előállításában.
generate.feature@<forrás_szolgáltatás_azonosító> = <szolgáltatás_azonosító> [, feature@<szolgáltatás_azonosító>]* [, plugin@<bedolgozó_azonosító>]* [, exclude@<bedolgozó_azonosító>]*
Egyéni forráskötegek előállításakor ez a tulajdonság változatlan marad, és ugyanazokat az attribútumokat támogatja (például version, unpack, optional, és így tovább), a különbgséget az eredményül kapott forrás szolgáltatásban lehet megfigyelni. Korábban a forrás szolgáltatás minden összeépítendő platformhoz tartalmazott egy forrás bedolgozót és egy forrás töredéket. Az új formátumban a forrás szolgáltatás egy forrás köteget fog tartalmazni az eredeti szolgáltatásban felsorolt egyes bedolgozókhoz és szolgáltatásokhoz.
A forrás szolgáltatásba a plugin@ szintaxissal befoglalt bedolgozókhoz nem tartozik megfelelő forrás köteg. Ez akkor hasznos, ha dokumentációs bedolgozókat ad hozzá a forrás szolgáltatáshoz.
Az exclude@ bejegyzés újdonság az egyéni források előállításánál. Előfordulhat, hogy az eredeti szolgáltatásban szereplő bizonyos bedolgozók (például a kizárólag natív kódot tartalmazó dokumentációs bedolgozók vagy töredékek) nem tartalmaznak kódot, és ezeket ki kell zárni az előállított forrás szolgáltatásból. Az exclude@ bejegyzés támogatja a version attribútumot.
Példa:generate.feature@org.eclipse.jdt.source=org.eclipse.jdt, plugin@org.eclipse.jdt.doc.isv;unpack="false",exclude@org.eclipse.jdt.doc.user
A régi formátumban a generate.plugin tulajdonság egy forrás bedolgozót állított elő egy adott szolgáltatás tartalma alapján. Az egyéni forráskötegek előállításakor úgy változik, hogy egy adott bedolgozó szolgál az előállítás alapjául:
generate.plugin@<forrás_bedolgozó_azonosító>=<bedolgozó_azonosító>
A generate.plugin tulajdonságot a szolgáltatások arra használták, hogy forrás szolgáltatás nélkül tartalmazzák a forrást (még akkor is, ha a háttérben egy teljes forrás szolgáltatás került előállításra). Egyéni forráskötegek előállításakor a szolgáltatásoknak tartalmazniuk kell egy *.source köteget minden egyes bedolgozóhoz, valamint mindegyikhez egy megfelelő generate.plugin tulajdonságot.
Példa: Az sdk.examples szolgáltatás így nézett ki:
<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
Ez így módosult:
<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
Vannak olyan bedolgozók, amelyekhez nem kell előállítani forrásköteget, mivel valójában nem tartalmaznak kódot. Ez történhet például a platform specifikus töredékek esetében, amelyek csak egy natív függvénytárat tartalmaznak. Ilyenkor a szolgáltatás kizárhatja kötegeket a fenti generate.feature tulajdonságnál vázoltak szerint.
Ennek alternatívájaként a kötegek kifejezetten meg is adhatják a saját build.properties fájljukban, hogy ezekhez nem kell előállítani forrásköteget:
generateSourceBundle=false
Egyéni tartalmat az előállított forráskötegekhez mindig az eredeti kötegben megadott post.gather.source egyéni visszahívás segítségével lehet hozzáadni. (Lásd: Szolgáltatás és bedolgozó egyéni összeépítési lépései).
Ilyenkor állítsa be a bedolgozó build.properties fájljában a "src.additionalRoots" tulajdonságot, hogy az előállított forráskötegnek helyes roots direktívája legyen az Eclipse-SourceBundle fejlécben.
Például:
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>
Korábban az előállított forrás bedolgozó szolgált az előállított forrásszolgáltatás cégjelzés bedolgozójaként. A cégjelzés fájlok (about.properties, eclipse32.gif, és így tovább) ez eredeti szolgáltatás sourceTemplatePlugin könyvtárával készült.
Egyéni forráskötegek előállításakor a forrásszolgáltatás cégjelzés bedolgozója az eredeti cégjelzés bedolgozónak megfelelő forrásköteg lesz. Ez azt jelenti, hogy a forrásszolgáltatás cégjelzés bedolgozójának cégjelzés fájljait az eredeti cégjelzés bedolgozó src.includes tulajdonságával lehet biztosítani.
A cégjelzés bedolgozóhoz hozzájárul annak a szolgáltatásnak a sourceTemplatePlugin mappája is, amelyhez a forrást előállítjuk.
Korábban az eredeti szolgáltatás sourceTemplatePlugin könyvtárának tartalma volt átmásolva a forrás bedolgozóba. Egyéni forráskötegek előállításakor ez csak a cégjelzés forrásköteg esetében lesz igaz (lásd fent).
Az összes többi forrásköteghez a sourceTemplateBundle könyvtár tartalma lesz átmásolva.