Versiosta 3.4 lähtien Eclipsen mukana on toimitettu yksittäiset lähderesurssijoukot, jotka mahdollistavat lähdekoodin joustavamman toimituksen. Lisätietoja on Yksittäiset lähderesurssijoukot -sivulla. Myös perinteisiä kansiomuotoisia lähdelisäosia voidaan yhä muodostaa alla kuvatulla tavalla.
Tutustu seuraavaan SDK-tuoteominaisuuteen:
features/
org.foo.sdk/
feature.xml: <includes id="org.foo.rcp" />
<includes id="org.foo.rcp.source" />
build.properties: generate.feature@org.foo.rcp.source = org.foo.rcp
org.foo.rcp/
feature.xml: <plugin id="org.foo.BundleA" />
<plugin id="org.foo.BundleB" />
<plugin id="org.foo.BundleB.win32" fragment="true" os="win32" />
Kyseinen SDK-tuoteominaisuus sisältää niin tuoteominaisuuden kuin kyseisen tuoteominaisuuden lähteen. Huomaagenerate.feature-ominaisuus tuoteominaisuuden build.properties-tiedostossa. Kyseinen ominaisuus ohjeistaa PDE-koonnin muodostamaan "org.foo.rcp.source"-nimisen tuoteominaisuuden, joka perustuu tuoteominaisuuden "org.foo.rcp" sisältöön. PDE-koonti muodostaa org.foo.rcp.source-tuoteominaisuuden, lähdekoodin sisältävän lisäosan ja tuoteominaisuuden mahdollisesti sisältämien käyttöympäristökohtaisten resurssijoukkojen lähteen sisältävät fragmentit:
features/
org.foo.rcp.source/
feature.xml: <plugin id="org.foo.rcp.source"/>
<plugin id="org.foo.rcp.source.win32" fragment="true" os="win32" />
plugins/
org.foo.rcp.source/src/
org.foo.BundleA/src.zip
org.foo.BundleB/src.zip
org.foo.rcp.source.win32/src/
org.foo.BundleB.win32/src.zip
Ominaisuuden generate.feature muoto on seuraavanlainen:
generate.feature@<source feature id> = <feature id> [, feature@<feature id>[;attribute=value]*]* [, plugin@<plugin id>[;attribute=value]*]*
Käyttämällä plugin@-ominaisuutta voit lisätä ylimääräisiä lisäosia, jotka eivät kuulu muodostetun lähdetuoteominaisuuden alkuperäiseen tuoteominaisuuteen. Tämä on hyödyllinen ominaisuus dokumentaatiolisäosissa. Ominaisuuden feature@ ja lähdemallipohjan avulla voidaan lähdetuoteominaisuuksia sijoittaa sisäkkäin (tutustu jäljempänä oleviin ohjeisiin).
Tuoteominaisuus, jonka perusteella lähdetuoteominaisuus muodostetaan, voi toimittaa muodostettavaan lähdetuoteominaisuuteen sisällytettäviä mallipohjatiedostoja:
features/
org.foo.rcp/
sourceTemplateFeature/<muodostettavaan lähdetuoteominaisuuteen sisällytettävät tiedostot>
sourceTemplatePlugin/<muodostettavaan lähdelisäosaan sisällytettävät tiedostot>
sourceTemplateFragment/<muodostettaviin käyttöympäristökohtaisiin fragmentteihin sisällytettävät tiedostot>
Mahdolliset kyseisissä sourceTemplate-kansioissa sijaitsevat tiedostot sisällytetään vastaavaan muodostettuunfeature/plug-in/fragment-kansioon. Kyseisten hakemistojen tiedostot korvaavat PDE-koonnin muodostamat tiedostot. Tämän avulla voi toimittaa mukautetun feature.xml-tiedoston, jos lähdetuoteominaisuudella on edellytyksiä, joita PDE-koonti ei tue.
Lähdetuoteominaisuuksia voi sijoittaa sisäkkäin toimittamalla sourceTemplateFeature/build.properties-tiedoston muodostetulle lähdetuoteominaisuudelle. Kyseisen tiedoston tulee sisältää generate.feature-ominaisuus sisäkkäin sijoitettavaa lähdetuoteominaisuutta varten. Sinun tulee myös varmistaa, että ylätason feature.xml-lähdetiedosto sisältää sisäkkäisen lähdetuoteominaisuuden. Tämän voi tehdä feature@-ominaisuuden avulla tai toimittamalla feature.xml-mallipohjatiedoston:
features/
org.foo.sdk/
sourceTemplateFeature/
build.properties: generate.feature@org.foo.nested.source = org.foo.nested
feature.xml: <includes id="org.foo.rcp" />
<includes id="org.foo.rcp.source" />
build.properties: generate.feature@org.foo.rcp.source = org.foo.rcp, feature@org.foo.nested.source
org.foo.rcp/...
org.foo.nested/...
On myös mahdollista muodostaa yksittäinen lähdelisäosa tuoteominaisuuden perusteella sen sijaan, että muodostettaisiin kokonainen lähdetuoteominaisuus. Tämän voi tehdä seuraavan ominaisuuden avulla:
generate.plugin@<source plug-in id>=<feature-in id>
Huomaa, että vanhan järjestelmän mukaiset lähdelisäosat, joissa yksi lisäosa sisältää ominaisuuden kaikkien lisäosien lähdekoodin, on asennettava käyttäen kansiomuotoa. Määritä unpack="true"-määrite tiedostossa feature.xml.
Esimerkki:features/
org.foo.sdk/
feature.xml: <plugin id="org.foo.rcp" />
<plugin id="org.foo.sdk.source" unpack="true" />
build.properties: generate.plugin@org.foo.sdk.source = org.foo.sdk