Steg vid anpassat bygge av funktioner och insticksprogram

En ny funktion i 3.2 är möjligheten att låta en funktion eller ett insticksprogram bidra med anpassade ant-mål till 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. Om xml-filen är placerad någon annanstans, använder du egenskapen customBuildCallbacks.buildpath för att ange den katalog som ska användas.

Mallar med namnet customBuildCallbacks.xml som innehåller anpassade mål som kan användas tillhandahålls i org.eclipse.pde.build/templates/plugins och  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. Som standard är "false" angivet för failonerror. Du ändrar det genom att ange "true" för egenskapen customBuildCallbacks.failonerror. På liknande sätt är standardvärdet för parametern inheritall "false". Ange customBuildCallbacks.inheritall för att ändra detta.

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: