Trin til tilpasset bygning af funktioner og plugins

En nyhed i 3.2 er, at en funktion eller plugin kan tilføje tilpassede ant-mål til sin egen bygning.Disse tilpassede trin kan f.eks. benyttes til oprettelse af bytekode efter kompilering, indeksering af hjælpefiler til dokumentation eller til kopiering af ekstra filer til bundtet. 

Hvis der skal benyttes tilpassede mål, skal en funktion eller plugin definere egenskaben customBuildCallbacks i filen build.properties. Værdien af denne egenskab er den relative placering af en xml-fil, der indeholder de tilpassede mål, i forhold til roden af funktionen eller plugin'en. Hvis xml-filen er placeret et andet sted, skal du bruge egenskaben customBuildCallbacks.buildpath til at angive det bibliotek, der skal anvendes.

Der findes skabeloner med navnet customBuildCallbacks.xml, som indeholder de understøttede tilpassede mål, i org.eclipse.pde.build/templates/plugins og  org.eclipse.pde.build/templates/features.Disse skabeloner kan kopieres til funktionen eller plugin'en og redigeres efter behov.

De tilpassede mål startes ved hjælp af opgaven subant. Som standard er failonerror angivet til false. Du kan ændre dette ved at angive egenskaben customBuildCallbacks.failonerror som sand. Parameteren inheritall er ligeledes angivet til false som standard. Angiv egenskaben customBuildCallbacks.inheritall for at ændre dette.

Plugins

Den genererede build.xml, der bygger en plugin, indeholder flere mål, som udfører bestemte opgaver. PDE Build tillader, at plugin'en stiller tilpassede pre- og post-mål til rådighed, som kaldes før og efter bestemte opgaver. Ud over eventuelle ant-egenskaber, som muligvis er defineret allerede, kan der overføres specifikke egenskaber til hvert tilpasset mål. Følgende mål understøtter tilpassede tilbagekald:

Funktioner

Den genererede build.xml til funktioner understøtter kun tilpassede byggetilbagekald for gather.bin.parts-mål. Dette mål starter gather.bin.parts-målet for alle de inkluderede funktioner og plugins.  Det understøtter pre.gather.bin.parts og post.gather.bin.parts.  Begge disse mål stilles til rådighed med følgende egenskaber: