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:
- baseLocation: la ubicación de una instalación de
Eclipse que contiene los subdirectorios features/ y plugins/ de todas
las características y plug-ins preconstruidos.
- baseos: indica el SO del Eclipse especificado por baseLocation.
- basews: indica el ws del Eclipse especificado por baseLocation.
- basearch: indica el archivador del Eclipse
especificado por baseLocation.
- buildDirectory:
el directorio en el que tendrá lugar la construcción. Establezca este valor en la
vía de acceso completa del directorio de construcción creado anteriormente.
- configs: lista las configuraciones para las
que desea construir la característica. Puede descomentar las configuraciones
suministradas (tenga cuidado con las continuaciones de línea). Si la característica que
está construyendo es independiente de plataforma, no es necesario establecer esta
propiedad, o puede establecerse en *,*,*.
- archivePrefix:
nombre del directorio en el que se descomprimirá la característica en disco.
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:
-buildfile=</vía_acceso/a/construcción.xml>
: Es la vía
de acceso al
archivo build.xml suministrado por la construcción. Se encuentra en el directorio
org.eclipse.pde.build/scripts. Es el archivo de construcción que controla todo el
proceso de construcción.
-Dbuilder=</vía_acceso/a/carpeta configuración>
:
Es la vía de acceso a la carpeta de configuración de la construcción.
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.