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 destinos ant personalizados a su propia construcción.  Estos pasos personalizados pueden 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. Si el archivo xml está ubicado en otra parte, utilice la propiedad customBuildCallbacks.buildpath para establecer el directorio a utilizar.

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.  Estas plantillas pueden copiarse en la característica o plug-in y modificarse según sea necesario.

Los destinos personalizados se invocarán durante la tarea subant; de forma predeterminada failonerror se establece en false. Para cambiar esto, establezca la propiedad customBuildCallbacks.failonerror en true. Del mismo modo, el parámetro inheritall toma el valor false de forma predeterminada. Establezca la propiedad customBuildCallbacks.inheritall para cambiar esto.

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: