Personalizar una construcción autónoma

Hay varios métodos para personalizar una construcción autónoma:

El formato exacto del contenido de estos archivos depende unos de otros. Por lo tanto, al utilizar personalizaciones customTargets, allElements o customAssembly, es recomendable asegurarse de que las plantillas utilizadas para estos archivos vienen de la misma versión de PDE/Build. Las versiones nuevas de PDE/Build son retrocompatibles con versiones antiguas de estos scripts de personalización.

Las versiones de plantilla de estos scripts están disponibles en el plug-in org.eclipse.pde.build bajo la carpeta templates/headless-build. Para utilizar la personalización, simplemente copie la plantilla en el directorio de configuración de construcción y edite los destinos adecuados.

customTargets.xml

El script customTargets.xml es para las personalización de nivel superior del proceso de construcción. Proporciona destinos ant a los que se llama entre las fases principales de la construcción. Hay destinos previos y posteriores disponibles alrededor de cada uno de los pasos de construcción siguientes:

Para utilizar el script customTargets.xml, simplemente cópielo del directorio de plantillas de PDE/Construcción en el directorio de configuración de construcción y edite los destinos ant adecuados. El script se detectará automáticamente y lo utilizará la construcción autónoma.

El customTargets.xml también proporciona delegación para el script allElements.xml para cada una de las fases de construcción.

allElements.xml

El script allElements.xml es una especie de script de delegación que se utiliza para ejecutar los diversos pasos de construcción sobre un elemento dado (normalmente una característica). Igual que con customTargets.xml, para utilizar estos pasos de personalización, copie la plantilla de PDE/Construcción en el directorio de configuración de construcción. En Eclipse 3.4, el elemento destino que se construirá puede especificarse en el archivo build.properties de configuración de construcción de nivel superior mediante las propiedades topLevelElementType y topLevelElementId. elementType debe establecerse en feature y elementId debe establecerse en el id de característica que desee construir.

 	<target name="allElementsDelegator">
 		<ant antfile="${genericTargets}" target="${target}">
	 		<property name="type" value="${topLevelElementType}" />
	 		<property name="id" value="${topLevelElementId}" />
 		</ant>
 	</target>

allElements.xml también proporciona destinos utilizados durante la fase de ensamblaje y empaquetado de la construcción. El destino defaultAssemble se llamará para ensamblar los archivadores para todas las plataformas. Si lo desea, pueden definirse destinos para plataformas individuales.

Para utilizar un destino personalizado para una plataforma dada, defina una propiedad "assemble.<element-id>[.<config>] y un destino correspondiente. La propiedad indica a PDE/Build que utilice este destino personalizado en lugar del destino predeterminado. Este destino personalizado puede utilizarse para otorgar al archivador un nombre personalizado o realizar un proceso previo o posterior sobre el archivador.

Ejemplo:

	<property name="assemble.org.foo.feature.id.linux.gtk.x86" value="true" />
 	<target name="assemble.org.foo.feature.id.linux.gtk.x86">
 		<property name="archiveName" value="acme-RCP-${buildId}-linux.gtk.x86.tar.gz" />
 		<-- pasos de preensamblado personalizados para linux.gtk.x86-->
 		<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
 		<-- pasos de postensamblado personalizados para linux.gtk.x86-->
 	</target>

customAssembly.xml

El script customAssembly.xml es nuevo en 3.4. Proporciona puntos de personalización a los que se llamará durante las fases de ensamblado y empaquetado de la construcción. Al igual que con customTargets.xml y allElements.xml, para utilizar esta personalización, copie la plantilla de PDE/Construcción en el directorio de configuración de construcción.

Los scripts de ensamblado y empaquetado generados por PDE/Construcción realizan las acciones siguientes:

Los scripts de ensamblado se ocupan de la recopilación de las características y los plug-ins compilados durante la construcción y los scripts de paquete se ocupan de la recopilación de las características y los plug-ins binarios precompilados. El script customAssembly.xml proporciona destinos antes o después de cada uno de los pasos indicados más arriba: