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 tipo@id[,versión] 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: |
opcional, 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 tipo@id[,versión] 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. Los plug-ins y las características deben estar ubicadas en las carpetas plugins y features respectivamente; |
| children : |
opcional, especifica si hay que invocar la generación de scripts para los plug-ins y fragmentos. El valor predeterminado está establecido en true. |
| recursiveGeneration : |
opcional, especifica si hay que invocar la generación de scripts para las características contenidas. El valor predeterminado 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 predeterminado 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 predeterminado 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; |
| 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; |
| filteredDependencyCheck : |
opcional, restringir el conjunto de plug-ins y características a tener en
cuenta durante la construcción a los que pueden alcanzar las características; |
| filterP2Base : |
opcional, restringir el conjunto de plug-ins y características
a tener en cuenta desde baseLocation a los que se considera que instala p2; |
| generateFeatureVersionSuffix: | opcional, indica si debe generarse el sufijo de versión de característica. Consulte también la sección Calificadores de versión; |
| generatedVersionLength : |
opcional, la longitud del sufijo de versión de característica generado. De forma predeterminada, se establece en 28. Consulte también la sección Calificadores de versión; |
| significantVersionDigits : |
opcional, el número de dígitos significativos utilizados al generar sufijos
de versión de característica.
Consulte también la sección Calificadores de versión; |
| 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; |
| featureId : |
El ID que debe darse a la característica
generada. |
| buildDirectory: |
El directorio en el que están ubicadas las características y los plug-ins
(en los subdirectorios /features y /plugins) a incluir. 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
extraerse de un depósito, establezca verify en False, utilice la característica
resultante para extraer 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. (Soporta atributos, ver más abajo) |
| featureList : |
opcional, una lista separada por comas de los
ID de característica que deben incluirse en la característica generada. (Soporta atributos, ver más abajo) |
| fragmentList : |
opcional, una lista separada por comas de los
ID de fragmento que deben incluirse en la característica generada. (Soporta atributos, ver más abajo) |
| buildPropertiesFile : |
opcional, la ubicación de un archivo de propiedades cuyo contenido debe utilizarse como el build.properties de la característica generada. |
| includeLaunchers : |
opcional, si se deben incluir o no los lanzadores de equinox, el valor predeterminado es "true". |
Los argumentos pluginList, featureList y fragmentList de la tarea eclipse.generateFeature soportan atributos. Estos argumentos tienen la forma:
Lista = <id-de-elemento>[;<atributo>=<valor>]* [,<id-de-elemento>[;<atributo>=<valor>]*]*
Cada par atributo=valor se insertará en el xml generado correspondiente al elemento dado. Ejemplo:
featureList = org.eclipse.feature;optional=true
pluginList = org.eclipse.plugin.A;unpack=true
fragmentList=org.eclipse.fragment.a;os=win32,org.eclipse.fragment.b;os=linux;ws=gtk;arch=x86
<feature ...>
...
<includes id="org.eclipse.feature" version="0.0.0" optional="true" />
...
<plugin id="org.eclipse.plugin.A" version="0.0.0" unpack="true" />
<plugin id="org.eclipse.fragment.a" version="0.0.0" os="win32" fragment="true" />
<plugin id="org.eclipse.fragment.b" version="0.0.0" os="linux" ws="gtk" arch="x86" fragment="true" />
...
</feature>
<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 -jar plugins/org.eclipse.equinox.launcher_<version>.jar -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.