Pasos de construcción personalizada de características y plug-ins

A partir de la versión 3.2, una característica o plug-in tiene capacidad para añadir pasos de construcción personalizada a su propia construcción.  Estos pasos personalizados puede utilizarse para operaciones tales como instrumentar el código de bytes después de la compilación, indexar archivos de ayuda para la documentación o copiar archivos adicionales en el paquete compuesto. 

Para utilizar destinos personalizados, una característica o plug-in debe definir la propiedad customBuildCallbacks en su archivo build.properties; el valor de este propiedad es la ubicación de un archivo xml en relación al directorio raíz de la característica o plug-in, que contiene los destinos personalizados.  Se suministran plantillas denominadas customBuildCallbacks.xml que contienen los destinos personalizados soportados en org.eclipse.pde.build/templates/plugins y  org.eclipse.pde.build/templates/features, respectivamente.  Estas plantillas pueden copiarse en la característica o plug-in y modificarse según sea necesario.  Los destinos personalizados se invocarán mediante la tarea subant con failonerror="false", por lo que la construcción continuará si el archivo xml personalizado no contiene un destino determinado o se produce un error.

Plug-ins

El archivo build.xml generado que construye un plug-in contiene varios destinos que realizan tareas específicas.   La construcción PDE permite al plug-in suministrar pre y postdestinos personalizados a los que se llamará antes y después de tareas específicas.  Además de las propiedades ant que ya puedan estar definidas, también puede pasarse a cada destino personalizado un par de propiedades específicas.  Los destinos siguientes dan soporte a llamadas de retorno personalizadas:

Características

El archivo build.xml generado para características sólo da soporte a llamadas de retorno de construcción personalizadas para el destino gather.bin.parts.  Este destino invocará el destino gather.bin.parts de todas las características y plug-ins incluidos.  Da soporte a pre.gather.bin.parts y post.gather.bin.parts.  Estos dos destinos se suministran con las propiedades siguientes: