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 proporcionado por 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 directorio de configuración de construcción

El primer paso de la configuración de una construcción consiste en crear el directorio de configuración de construcción. Se trata del directorio en el que se guardan los archivos que controlan y personalizan la construcción autónoma.

El archivo principal para controlar la construcción es el archivo build.properties de configuración de construcción de nivel de superior. Al establecer una construcción nueva, copie el archivo de plantilla del paquete org.eclipse.pde.build en la instalación de eclipse que utilizará para ejecutar la construcción. El archivo de plantilla está ubicado bajo org.eclipse.pde.build/templates/headless-build/build.properties.

A este directorio se refieren las propiedades builder que normalmente se establecen en la línea de mandatos de ant.

buildDirectory

La propiedad buildDirectory especifica el directorio en el que PDE/Construcción generará scripts y realizará la construcción real. Los plug-ins y las características que se están construyendo deben colocarse en los subdirectorios ${buildDirectory}/plugins y ${buildDirectory}/features. Si los paquetes y las características se captan desde un repositorio (consulte Captar de repositorios), se colocarán aquí también.

Este directorio puede ser el mismo que el directorio de configuración de construcción o puede ser un directorio diferente. Puede ser deseable utilizar un directorio aparte, especialmente si la configuración de construcción se guarda en CVS y no desea ensuciarla con artefactos de construcción generados.

Propiedades iniciales

Para configurar una construcción de característica básica, debe editar el archivo build.properties de configuración de construcción y establecer las propiedades siguientes:

La versión anterior de PDE/Construcción también necesitaba un archivo allElements.xml que ya no es necesario en 3.4. allElements.xml puede seguir utilizándose pero solo es necesario si desea personalizar determinados aspectos de la construcción. Consulte el apartado Personalizar una construcción autónoma.

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>/plugins/org.eclipse.equinox.launcher_<versión>.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, la extracción desde un depósito, consulte los temas de Construcción PDE avanzada para obtener más información.