Egyéni forráskötegek

Az Eclipse forráskötegek hagyományos formátuma egy mappa volt, amely tartalmazta egy adott szolgáltatásban szereplő összes bedolgozó src.zip fájlját. A 3.4 kiadástól az Eclipse szállítása egyéni forráskötegekkel történik. Minden egyes köteghez tartozik egy megfelelő forrásköteg, ami tulajdonképpen az adott köteg forrását tartalmazó JAR fájl. Ez lehetővé teszi a források rugalmasabb szállítását, és megoldást biztosít az útvonal hosszúságának problémáira is, ami egyes platformokon gondot okozhat.

Eclipse-SourceBundle

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.

Egyéni forráskötegek előállítása

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

Egy szolgáltatás build.properties fájljában a generate.feature tulajdonság utasítja a PDE összeépítés bedolgozó egy forrás szolgáltatás elóállítására.
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

generate.plugin

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

generateSourceBundle

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 tartalom

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>

A forrásszolgáltatás cégjelzése

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.

sourceTemplatePlugin vagy sourceTemplateBundle

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.