Construir características

La Construcción PDE se suministra con una infraestructura destinada a automatizar la construcción de características. La mayor parte de la configuración necesaria para una construcción de este tipo puede realizarse mediante algunas modificaciones del archivo de plantilla build.properties suministrado en la construcción PDE. La sección que sigue se centra en la puesta a punto de una configuración sencilla, suponiendo que todos los plug-ins y características (tanto para la construcción como preconstrucción) a los que haga referencia la característica que se construye ya estén disponibles localmente en disco.

Configuración básica

El primer paso de la configuración de una construcción consiste en crear el directorio en el que tendrá lugar la construcción. Este directorio se conocerá como directorio de construcción y contendrá los plug-ins y características necesarios para la construcción, así como los artefactos generados. A continuación, copie los plug-ins y características en los subdirectorios "plugins" y "features", respectivamente. Se espera que la carpeta de característica (feature) contenga la característica que se construye.

El segundo paso de la configuración de una construcción consiste en copiar el archivo de plantilla build.properties desde org.eclipse.pde.build/templates/headless-build en un directorio nuevo que será el directorio de construcción de configuración (también llamado directorio de configuración). Edite el archivo build.properties copiado y establezca las propiedades siguientes:

Controlar lo que se construirá: allElements.xml

Copie el archivo allElements.xml desde org.eclipse.pde.build/templates/headless-build en el directorio de configuración. Este es el archivo que indica al PDE qué característica se está construyendo.  Este archivo contiene dos tipos de destinos:  allElementsDelegator, que especifica la característica que se construye, y los destinos de ensamblado a los que se llama para ensamblar configuraciones individuales.  El destino allElementsDelegator para una característica denominada org.foo.Feature es:
 	<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="feature" />
<property name="id" value="org.foo.Feature" />
</ant>
</target>
Los destinos de ensamblado permiten controlar el nombre del archivador final en función de la configuración.  Debe tener un destino para cada configuración que construya.  Por ejemplo, al construir org.foo.Feature para Windows (cuando configs está establecido en win32, win32, x86), debe tener el siguiente destino:
<!--Destino para ensamblar os=win32, ws=win32,
arch=x86 -->
<target name="assemble.org.foo.Feature.win32.win32.x86">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}/">
</target>
Al construir una configuración independiente de plataforma (cuando configs no está establecido o lo está en *,*,*), debe tener un destino como el siguiente:
<!--El destino de ensamblado independiente de
plataforma-->
<target name="assemble.org.foo.Feature">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
</target>

Ejecutar la construcción

Para ejecutar la construcción, utilizará la aplicación org.elipse.ant.core.antRunner. Al invocar eclipse con esta aplicación para realizar una construcción, debe establecer dos argumentos en la línea de mandatos:
Ejecute la aplicación antRunner mediante el mandato siguiente:
java -jar <instalaciónEclipse>/startup.jar -application org.eclipse.ant.core.antRunner -buildfile <<instalaciónEclipse>/plugins/org.eclipse.pde.build_<versión>/scripts/build.xml> -Dbuilder=<vía de acceso a la carpeta de configuración de la construcción>
Una vez finalizada la construcción, puede obtener el resultado en el directorio de construcción, en la carpeta llamada I.TestBuild (este nombre puede configurarse estableciendo la propiedad buildLabel).

Escenarios avanzados

Si requiere una mayor personalización de la construcción, por ejemplo, para captar desde un repositorio, consulte los temas de Construcción PDE avanzada para obtener más información.