Yksittäiset lähderesurssijoukot

Eclipse-järjestelmän lähderesurssijoukkojen perinteinen muoto oli kansio, joka sisälsi kaikkien tietyn tuoteominaisuuden sisältämien lisäosien src.zip-tiedostot. Versiosta 3.4 alkaen Eclipse sisältää yksittäisiä lähderesurssijoukkoja. Kutakin resurssijoukkoa vastaa lähderesurssijoukko, joka on kyseisen resurssijoukon lähteen sisältävä jar-tiedosto. Tällöin lähteen toimitus on joustavampaa ja tietyissä käyttöympäristöissä ilmenevät polkujen pituusongelmat helpottuvat.

Eclipse-SourceBundle

Lähderesurssijoukon tunnistaa Eclipse-SourceBundle-otsikosta manifest-tiedostossa. Tämän otsikon muoto on seuraavanlainen:

Eclipse-SourceBundle: <bundle-id>;version=<version>;roots:="root1, root2"

Resurssijoukon tunniste ja versio ilmaisevat resurssijoukon, jota sisällytetty lähdekoodi vastaa. Roots-ohjauskoodi ilmaisee lähderesurssin kansiot, jotka sisältävät lähdekoodia. Jos roots-ohjauskoodia ei ole määritetty, järjestelmä käyttää oletusarvoa ".".

Luokkatiedostokirjastot on määritetty vastaamaan lähdesijainteja ennakoitavalla tavalla. Lisäosan juuri vastaa lähderesurssijoukon juurta. Tämä pätee useimpiin jar-arkistoituihin lisäosiin. Jos lisäosa sisältää lisäkirjastoja (foo/lib.jar), lähteen tulisi olla vastaavissa foo/libsrc/-kansioissa lähderesurssijoukoissa.

Yksittäisten lähderesurssijoukkojen muodostus

PDE/koonti voi muodostaa yksittäisiä lähderesurssijoukkoja automaattisesti, mutta vain näyttöpäätteettömässä koonnissa. Voit ottaa yksittäisten lähderesurssijoukkojen muodostuksen käyttöön seuraavalla määrityksellä:

individualSourceBundles=true

Tämä määritys on annettava koontikokoonpanon ylimmän tason build.properties-tiedostossa, ja se ohjaa kyseisen koonnin kaikkea lähteen muodostusta. Lisätietoja perinteisten lähdelisäosien ja -tuoteominaisuuksien muodostuksesta on kohdassa Lähdetuoteominaisuuksien ja -lisäosien muodostus. Jäljempänä tällä sivulla oletetaan, että lukija tuntee perinteistä lähteen muodostusta.

generate.feature

Tuoteominaisuuden build.properties-tiedostossa generate.feature-ominaisuus osoittaa, että pde.build-toiminnon on muodostettava lähdetuoteominaisuus.
generate.feature@<source feature id> = <feature id> [, feature@<feature id>]* [, plugin@<plugin id>]* [, exclude@<plugin id>]*

Muodostettaessa yksittäisiä lähderesurssijoukkoja tämä ominaisuus säilyy ennallaan ja tukee samoja määritteitä (esimerkiksi määritteitä version, unpack ja optional). Ero tulee esille tuloksena olevassa lähdetuoteominaisuudessa. Aikaisemmin lähdetuoteominaisuus sisälsi yhden lähdelisäosan sekä lähdefragmentin kutakin koottavaa käyttöympäristöä kohti. Uudessa muodossa lähdetuoteominaisuus sisältää lähderesurssijoukon kutakin alkuperäisen tuoteominaisuuden luetteloimaa lisäosaa/fragmenttia kohti.

Lisäosille, jotka on sisällytetty lähdetuoteominaisuuteen plugin@-syntaksin avulla, ei muodostu vastaavia lähderesurssijoukkoja. Tästä on hyötyä lisättäessä doc-lisäosia lähdetuoteominaisuuteen.

Merkintä exclude@ on uusi yksittäisten lähteiden muodostuksessa. Joillakin alkuperäiseen tuoteominaisuuteen sisällytetyillä lisäosilla (eli doc-lisäosilla tai fragmenteilla, jotka sisältävät vain alkuperäiskoodia) ei ehkä ole lähdettä, ja ne on jätettävä pois muodostettavasta lähdetuoteominaisuudesta. Merkintä exclude@ tukee määritettä version.

Esimerkki:
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

Vanhassa muodossa ominaisuus generate.plugin muodostaa lähdelisäosan tietyn tuoteominaisuuden sisällön perusteella. Muodostettaessa yksittäisiä lähderesurssijoukkoja perusteena on tietty lisäosa:

generate.plugin@<source plug-in id>=<plug-in id>

Tuoteominaisuudet käyttivät ominaisuutta generate.plugin sisällytettäessä lähdekoodia ilman lähdetuoteominaisuutta (vaikka taustalla muodostuikin kokonainen lähdetuoteominaisuus). Muodostettaessa yksittäistä lähderesurssjoukkoa tuoteominaisuuksien on sisällytettävä kutakin lisäosaa varten *.source-resurssijoukko vastaavan generate.plugin-ominaisuuden lisäksi.

Esimerkki: Tuoteominaisuus sdk.examples oli aiemmin seuraavanlainen:

   	<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

Tuoteominaisuus muuttuu seuraavanlaiseksi:

	<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

Tietyt lisäosat eivät edellytä lähderesurssijoukkoja, koska ne eivät sisällä lähdekoodia. Tällainen tilanne voi ilmetä käyttöympäristökohtaisissa fragmenteissa, jotka sisältävät vain alkuperäiskirjaston. Tällöin tuoteominaisuus voi jättää resurssijoukot pois edellä kohdassa generate.feature kuvatulla tavalla.

Resurssijoukot voivat myös määrittää eksplisiittisesti omassa build.properties-tiedostossaan, että niille ei muodosteta lähderesurssijoukkoa:

generateSourceBundle=false

Mukautettu sisältö

Muodostettuihin lähderesurssijoukkoihin voi aina lisätä mukautettua sisältöä käyttämällä mukautettua post.gather.source-vastakutsua alkuperäisessä resurssijoukossa. (Katso kohta Tuoteominaisuuksien ja lisäosien mukautetun koonnin vaiheet).

Määritä tässä yhteydessä ominaisuus src.additionalRoots lisäosan build.properties-tiedostossa siten, että lähderesurssijoukon muodostuksella on oikea roots-ohjauskoodi Eclipse-SourceBundle-otsikossa.

Esimerkki:

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>

Lähdetuoteominaisuuden tuotteistus

Aiemmin muodostettu lähdelisäosa toimi muodostetun lähdetuoteominaisuuden tuotteistuslisäosana. Tuotteistustiedostot (about.properties, eclipse32.gif ja niin edelleen) olivat käytettävissä alkuperäisen tuoteominaisuuden sourceTemplatePlugin-hakemistossa.

Muodostettaessa yksittäisiä lähderesurssijoukkoja lähdetuoteominaisuuden tuotteistuslisäosa on alkuperäistä tuotteistuslisäosaa vastaava lähderesurssijoukko. Tällöin lähdetuoteominaisuuden tuotteistuslisäosan tuotteistustiedostoja voi käyttää src.includes-ominaisuuden avulla alkuperäisessä tuotteistuslisäosassa.

Sen tuoteominaisuuden sourceTemplatePlugin-kansio, jolle muodostetaan lähde, sisältää myös tuotteistuslisäosalle tarkoitettuja tiedostoja.

sourceTemplatePlugin ja sourceTemplateBundle

Aikaisemmin alkuperäisen tuoteominaisuuden sourceTemplatePlugin-hakemiston sisältö kopioitui lähdelisäosaan. Muodostettaessa yksittäisiä lähderesurssijoukkoja tämä koskee vain tuotteistuksen lähderesurssijoukkoa (katso edellä).

Kaikkien muiden lähderesurssijoukkojen osalta sourceTemplateBundle-hakemiston sisältö kopioituu.