Los scripts Ant se generan normalmente con el entorno de desarrollo de
plug-ins (PDE), pero también es posible generarlos manualmente o a partir de
otros scripts.
En efecto, el PDE presenta las tareas Ant que permiten generar los diversos
scripts de construcción.
Los servicios de generación de scripts de construcción
residen en las clases que se indican a continuación. También se proporciona
la lista de argumentos de cada tarea.
elements: |
la entrada que se extraerá. El formato esperado es type@id como se especifica en el formato de archivo de directorio; |
buildDirectory: |
directorio en el que se generarán los scripts de extracción y en el que se reservarán los proyectos de características y plug-ins; |
directory: |
la vía de acceso a un archivo de directorio; |
children: |
propiedad opcional que especifica si hay que invocar la generación de scripts para los plug-ins y fragmentos. El valor predeterminado está establecido en true. |
cvspassfile: |
opcional, el nombre de un archivo de contraseña de CVS; |
fetchTag: |
opcional, altera temporalmente el código proporcionado en el archivo de directorio por el valor dado; |
configInfo: |
opcional, una lista de configuración separada por símbolos ampersand que indica la configuración destino. El valor por omisión es que sea independiente de plataforma; |
recursiveGeneration: |
opcional, especifique si deben generarse scripts de extracción para las características anidadas. El valor por omisión está establecido en true. |
elements : |
la entrada que debe construirse. Se espera que la entrada tenga el formato type@id como se especifica en el formato de archivo de directorio; |
buildDirectory : |
el directorio en el que se encuentran las características y plug-ins que deben construirse; |
children : |
opcional, especifica si hay que invocar la generación de scripts para los plug-ins y fragmentos. El valor por omisión está establecido en true. |
recursiveGeneration : |
opcional, especifica si hay que invocar la generación de scripts para las características contenidas. El valor por omisión está establecido en true. |
devEntries : |
opcional, una lista separada por comas de los directorios que se entregarán a la vía de acceso de clases de compilación; |
buildingOSGi : |
opcional, indica si el
destino es 3.x. o 2.1. El valor predeterminado es true; |
baseLocation : |
opcional, indica una carpeta que contiene una instalación Eclipse destino con subdirectorios features/ y plugins/. |
configInfo : |
opcional, una lista de configuración separada por símbolos ampersand que indica la configuración destino. El valor por omisión es que sea independiente de plataforma; |
pluginPath : |
opcional, una lista separada por separadores de archivos de plataforma de las ubicaciones desde las que buscar plug-ins adicionales. |
archivesFormat : |
opcional, una lista de configuraciones separada por símbolos ampersand y el formato de salida esperado para cada una de ellas. El formato va separado por un guión (-) de la configuración. Los valores soportados son: carpeta, tar, zip, antZip, que significan, respectivamente, no archivar, utilizar tar para crear el archivador, utilizar la versión de info zip disponible en la plataforma, utilizar ant zip. El valor por omisión es antZip. |
product : |
opcional, vía de acceso separada por '/' a la ubicación de un producto RCP en construcción. El primer segmento de la vía de acceso debe hacer referencia al ID de plug-in de un plug-in que contenga el archivo .product. |
signJars : |
opcional, indica si los scripts generados deben firmar los jar para las características y plug-ins. El valor por omisión es false. Los parámetros para la tarea de firma están controlados por las siguientes propiedades de ant: sign.alias, sign.keystore y sign.storepass, que se pasan respectivamente a los parámetros de alias, keystore y storepass de la tarea de ant signJar. El valor por omisión es false. |
generateJnlp : |
opcional, indica si deberá generarse un archivo jnlp para todas las características que se construyen. |
outputUpdateJars : |
opcional, genera plug-ins y características en el formato del sitio de actualizaciones. El valor por omisión es false. Tenga en cuenta que site.xml no se genera ni se actualiza. |
forceContextQualifier : |
opcional,
utiliza el valor dado para sustituir el .qualifier por plug-ins y
características. (Consulte también la sección Calificadores de versión) |
generateFeatureVersionSuffix: | opcional, indica si debe generarse el sufijo de versión de característica. |
groupConfiguration
: |
opcional, indica si deben agruparse todas las
configuraciones construidas en un solo archivador. |
generateVersionsLists : |
opcional, indica si deben generarse archivos
de propiedades que listen las versiones de las características y plug.ins construidos. |
featureId : |
El ID que debe darse a la característica
generada. |
buildDirectory: |
el directorio en el que se encuentran las
características y plug-ins que deben incluirse (en los subdirectorios /features y
/plugins). La característica generada se colocará en el subdirectorio /features. |
baseLocation : |
opcional, indica una
carpeta que contiene características y plug-ins instalados. |
productFile : |
opcional, un archivo de producto en el que se
basará la característica generada. |
verify : |
Indica si debe utilizarse el resolviente para
verificar que los plug-ins y características suministradas están disponibles.
También determina si la característica estará disponible para manejar correctamente
fragmentos y plug-ins específicos de plataforma que se colocarán en archivos JAR. Si
todos los elementos que deben incluirse en la característica están disponibles
localmente, la propiedad verify debe establecerse en True. Si los elementos deben
captarse de un repositorio, establezca verify en False, utilice la característica
resultante para captar los plug-ins y características necesarios y luego vuelva a
generar la característica contenedora utilizando verify = True. |
pluginPath : |
opcional, una lista separada por separadores de archivos de plataforma de las ubicaciones desde las que buscar plug-ins adicionales. |
configInfo : |
opcional, una lista de configuración separada por símbolos ampersand que indica la configuración destino. El valor por omisión es que sea independiente de plataforma; |
pluginList : |
opcional, una lista separada por comas de los
plug-ins que deben incluirse en la característica generada. |
featureList : |
opcional, una lista separada por comas de los
ID de característica que deben incluirse en la característica generada. |
fragmentList : |
opcional, una lista separada por comas de los
ID de fragmento que deben incluirse en la característica generada. |
<eclipse.fetch elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
directory="directory.txt"
configInfo="win32,win32,x86 & linux, motif, x86"
/>
<eclipse.buildScript elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
archivesFormat="macosx, carbon, ppc - tar"/>
Las tareas descritas anteriormente solo funcionan si Eclipse se está ejecutando. En el caso particular de ejecutar los scripts Ant mediante tareas de Eclipse, los scripts se deben ejecutar con la aplicación antRunner de Eclipse. La línea de mandatos de este caso particular es:
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
Observe que los parámetros que figuran después de la aplicación son los que se pasan a Ant.