Trinn i tilpasset bygging av funksjoner og plugin-moduler

En nyhet i 3.2 er muligheten en funksjon eller plugin-modul har til å bidra med tilpassede Ant-mål i egen bygging. Disse tilpassede trinnene kan brukes til saker som instrumentering av bytekode etter kompilering, indeksering av hjelpefiler til dokumentasjon eller kopiering av ekstrafiler til bunten. 

Hvis du vil bruke tilpassede mål, må en funksjon eller plugin-modul definere egenskapen customBuildCallbacks i sin egen build.properties-fil. Verdien til denne egenskapen er plasseringen av en XML-fil, i forhold til roten av funksjonen/plugin-modulen, som inneholder de tilpassede målene. Hvis XML-filen befinner seg et annet sted, bruker du egenskapen customBuildCallbacks.buildpath til å definere hvilken katalog som skal brukes.

Maler kalt customBuildCallbacks.xml som inneholder de støttede tilpassede målene, finnes i henholdsvis org.eclipse.pde.build/templates/plugins og org.eclipse.pde.build/templates/features. Disse malene kan kopieres til feature/plug-in og endres etter behov.

De tilpassede målene blir aktivert ved hjelp av subant-oppgaven. Som standard er failonerror satt til usann. Du kan endre dette ved å sette egenskapen customBuildCallbacks.failonerror til sann. Likeledes har parameteren inheritall usann som standardverdi. Definer egenskapen customBuildCallbacks.inheritall for å endre dette.

Plugin-moduler

Den genererte build.xml som bygger en plugin-modul, inneholder flere mål som utfører bestemte oppgaver. Med PDE Build kan plugin-modulen sørge for tilpassede pre- og post-mål som det blir sendt kall til før og etter bestemte oppgaver. I tillegg til eventuelle Ant-egenskaper som allerede kan være definert, må det også sendes et par spesifikke egenskaper til hvert tilpassede mål. De følgende målene støtter tilpassede tilbakekall:

Funksjoner

Den genererte build.xml for funksjoner støtter bare tilbakekall ved tilpassede bygginger for målet gather.bin.parts.  Dette målet aktiverer målet gather.bin.parts for alle de inkluderte funksjonene og plugin-modulene. Det støtter pre.gather.bin.parts og post.gather.bin.parts. Begge disse målene har de følgende egenskapene: