Tuoteominaisuuksien ja lisäosien mukautetun koonnin vaiheet

Versiossa 3.2 on uusi tuoteominaisuuden tai lisäosan ominaisuus, jonka avulla voi toimittaa mukautettuja ant-kohteita sen omaan koontiin.  Näitä mukautettuja vaiheita voi käyttää esimerkiksi BCI-instrumentointiin käännöksen jälkeen, ohjetiedostojen indeksointiin dokumentaatiota varten tai ylimääräisten tiedostojen kopiointiin resurssijoukkoon. 

Mukautettujen kohteiden käyttöä varten tuoteominaisuuden tai lisäosan on määritettävä ominaisuus customBuildCallbacks build.properties-tiedostossaan. Kyseisen ominaisuuden arvo on xml-tiedoston feature/plug-in-hakemiston juureen nähden suhteellinen sijainti, joka sisältää mukautetut kohteet. Jos xml-tiedosto sijaitsee muualla, määritä käytettävä hakemisto customBuildCallbacks.buildpath-ominaisuuden avulla.

Mallipohjat nimeltä customBuildCallbacks.xml, jotka sisältävät tuetut mukautetut kohteet, ovat kohteissa org.eclipse.pde.build/templates/plugins ja  org.eclipse.pde.build/templates/features.  Kyseisiä mallipohjia voi kopioida feature/plug-in-hakemistoon, ja niitä voi muokata tarpeen mukaan.

Mukautetut kohteet kutsutaan ant-alitehtävän avulla. Parametrin failonerror oletusarvo on false. Voit muuttaa tämän määrittämällä ominaisuuden customBuildCallbacks.failonerror arvoksi true. Vastaavasti parametrin inheritall oletusarvo on false. Voit muuttaa tämän määrittämällä ominaisuuden customBuildCallbacks.inheritall.

Lisäosat

Muodostettu lisäosan kokoava build.xml-tiedosto sisältää useita kohteita, jotka suorittavat tiettyjä tehtäviä.  PDE-koonnin avulla lisäosa voi toimittaa mukautettuja esi- ja jälkikohteita, joita kutsutaan ennen tiettyjä tehtäviä tai tiettyjen tehtävien jälkeen.  Mahdollisten jo määritettyjen ant-ominaisuuksien lisäksi kullekin mukautetulle kohteelle voidaan välittää muutama erityisominaisuus.  Seuraavat kohteet tukevat mukautettuja vastakutsuja:

Tuoteominaisuudet

Tuoteominaisuuksille muodostettu build.xml-tiedosto tukee mukautettuja koonnin vastakutsuja vain gather.bin.parts-kohteen osalta.  Kyseinen kohde kutsuu kaikkien sisältyvien tuoteominaisuuksien ja lisäosien gather.bin.parts-kohteen.  Se tukee kohteita pre.gather.bin.parts ja post.gather.bin.parts.  Näissä kohteissa on molemmissa seuraavat ominaisuudet: