Ant scripts are typically generated using the Plug-in Development
Environment (PDE), but it is also possible to generate
them by hand or from other scripts.
Indeed PDE exposes Ant tasks to generate the various build scripts.
Build script generation facilities
reside in the following tasks. Arguments are also listed for each
task.
elements: |
the entry that will be fetched. The format expected is of the form type@id as specified in the directory file format; |
buildDirectory: |
the directory into which fetch scripts will be generated and into which features and plug-in projects will be checked out; |
directory: |
the path to a directory file; |
children: |
optional, specifies whether the script generation for contained plug-ins and fragments should be invoked. Default is set to true; |
cvspassfile: |
optional, the name of a CVS password file; |
fetchTag: |
optional, overrides the tag provided in directory file by the given value; |
configInfo: |
optional, an ampersand separated list of configuration indicating the targeted configuration. The default is set to be platform independent; |
recursiveGeneration: |
optional, specify whether or not fetch scripts should be generated for nested features. The default is set to true. |
elements : |
the entry to be built. Entry is expected to be of the form type@id as specified in the directory file format; |
buildDirectory : |
the directory where the features and plug-ins to build are located; |
children : |
optional, specifies whether the script generation for contained plug-ins and fragments should be invoked. Default is set to true; |
recursiveGeneration : |
optional, specified whether the script generation for contained features should be invoked. Default is set to true; |
devEntries : |
optional, a comma separated list of directories to be given to the compile classpath; |
buildingOSGi : |
optional, indicates if the
target is 3.x.
or 2.1. Default is true; |
baseLocation : |
optional, indicates a folder which containing a target eclipse install with features/ and plugins/ subdirectories. |
configInfo : |
optional, an ampersand separated list of configuration indicates the targeted configuration. The default is set to be platform independent; |
pluginPath : |
optional, a platform file separator separated list of locations from which to find additional plug-ins |
archivesFormat : |
optional, an ampersand separated list of configs and the expected output format for each of those. The format is separated by a dash (-) from the configuration. The values supported are: folder, tar, zip, antZip, respectively meaning don't archive, use tar to create the archive, use the version of info zip available on the platform, use ant zip . The default value is antZip. |
product : |
optional, '/' separated path to the location of an RCP product being built. The first segment of the path must refer to the plug-in id of a plug-in containing the .product file. |
signJars : |
optional, indicates if the scripts generated must sign jars for features and plug-ins. The default value is false. The parameters to the sign task are controlled by the following ant properties: sign.alias, sign.keystore and sign.storepass respectively being passed to the alias, keystore and storepass parameters from the ant signJar task. The default value is false. |
generateJnlp : |
optional, indicates if a jnlp file should be generated for all the features being built. |
outputUpdateJars : |
optional, generates plug-ins and features in the update site format when set. The default value is false. Note that the site.xml is not generated nor updated |
forceContextQualifier : |
optional, uses the given
value to
replace the .qualifier being by plug-ins and features. (See also Version Qualifiers) |
generateFeatureVersionSuffix: | optional, whether or not to generate the feature version suffix. |
groupConfiguration
: |
optional, whether or not to
group all configurations being built into a single archive. |
generateVersionsLists : |
optional, whether or not to
generate properties files listing the versions of features and plug-ins
that were built. |
featureId : |
The id to give to the
generated Feature. |
buildDirectory: |
the directory where the
features and plug-ins (in /features and /plugins subdirectories) to
include are located. The generated feature will be placed in the
/features subdirectory. |
baseLocation : |
optional, indicates a folder
which contains installed features and plug-ins |
productFile : |
optional, a product file on
which to base the generated feature. |
verify : |
Whether or not to use the
resolver to verify that the provided plug-ins and features are
available. This also determines whether or not the the feature
will be able to correctly handle platform specific fragments and
plug-ins that will be JARed. If all the elements to be included
in the feature are available locally, then verify should be set to
True. If the elements need to be fetched from a repository, set
verify to False, use the resulting feature to fetch the required
plug-ins and features, then regenerate the container feature using
verify = True. |
pluginPath : |
optional, a platform file separator separated list of locations from which to find additional plug-ins |
configInfo : |
optional, an ampersand separated list of configuration indicates the targeted configuration. The default is set to be platform independent; |
pluginList : |
optional, a comma separated
list of plug-in ids to include in the generated feature. |
featureList : |
optional, a comma separated
list of feature ids to include in the generated feature. |
fragmentList : |
optional, a comma separated
list of fragment ids to include in the generated 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"/>
The tasks previously described only work if Eclipse is running. In the particular scenario of executing Ant scripts using Eclipse tasks,the scripts must be run using the Eclipse Ant Runner application. The command line for this particular case is the following:
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
Note that the parameters appearing after the application are the parameters that are passed to Ant.