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.
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/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@<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
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
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
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>
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.
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.