Steg vid anpassat bygge av funktioner och insticksprogram

En ny funktion i 3.2 är möjligheten för en funktion eller ett insticksprogram att lägga till anpassade steg i sitt eget bygge.  De här anpassade stegen kan till exempel användas till att instrumentera bytekod efter kompilering, indexera hjälpfiler för dokumentation eller kopiera extra filer till samlingspaketet.  

Om anpassade mål ska användas för en funktion eller ett insticksprogram måste egenskapen customBuildCallbacks definieras i filen build.properties för den. Värdet för den här egenskapen är platsen för en xml-fil, relativt roten för funktionen/insticksprogrammet, som innehåller de anpassade målen.  Mallar med namnet customBuildCallbacks.xml som innehåller anpassade mål som kan användas tillhandahålls i org.eclipse.pde.build/templates/plugins and  respektive org.eclipse.pde.build/templates/features. De här mallarna kan kopieras till funktionen/insticksprogrammet och ändras efter önskemål.  De anpassade målen anropas med hjälp av Ant-deluppgiften med failonerror="false", så att bygget kan fortsätta om xml-filen med anpassade inte innehåller ett visst mål eller om ett fel inträffar.

Insticksprogram

Den genererade build.xml som bygger ett insticksprogram innehåller flera mål som utför specifika uppgifter.  PDE-bygget gör det möjligt för insticksprogrammet att tillhandahålla för- och eftermål som anropas före och efter specifika uppgifter.  Förutom eventuella Ant-egenskaper som redan är definierade kan några specifika egenskaper också överföras till varje anpassat mål.  Följande mål har funktioner för anpassade återanrop:

Funktioner

Den genererade build.xml för funktioner kan endast användas med anrop för anpassade byggen för målet gather.bin.parts.  Det här målet kan anropa gather.bin.parts-målet för alla ingående funktioner och insticksprogram.   Det kan användas med pre.gather.bin.parts och post.gather.bin.parts.  Båda de här målen har följande egenskaper: