An Ant scenario is associated usually with an Ant build script.
Oxygen XML Developer
runs an Ant scenario as an
external process that executes the Ant build script with the built-in Ant distribution (Apache
Ant version 1.8.2) that comes
with the
application
or optionally with a custom Ant distribution configured in the scenario.
The following parameters are available on the Options tab:
- Working directory - Path of the current directory of the Ant
external process. An editor variable can be inserted in this text box using the small green arrow
button (
).
- Build file - Ant script file that is the input of the Ant external
process. An editor
variable can be inserted in this text box using the small green arrow button
(
).
- Build target - Optionally a build target from the Ant script file
can be specified. If no target is specified the Ant target that is specified as default in
the Ant script file will be executed.
- Additional arguments - Additional command-line arguments to be
passed to the Ant transformation (for example -verbose).
- Ant Home - Path to the Ant installation to run the transformation.
By default it is the Ant installation version 1.8.2 that is bundled with
Oxygen XML Developer
. A custom Ant
installation can also be set.
- Java Home - The path to the Java Virtual Machine that runs the Ant
transformation. By default it is the Java Virtual Machine that is bundled with
Oxygen XML Developer
. A custom Java virtual
machine can also be set.
- JVM Arguments - This parameter allows you to set specific
parameters to the Java Virtual Machine used by Ant. By default it is set to
-Xmx256m which means the transformation process is allowed to use 256
megabytes of memory. Sometimes, when performing a large DITA map transformation you may want
to increase the memory allocated to the Java Virtual Machine from the default value (256 MB)
to a higher value, like 512 MB. In this way, you can avoid running out of memory
(OutOfMemoryError) when running an Ant process.
- Libraries - This button allows adding to the classpath of the Ant
process any external libraries that are not bundled with Ant (that is they are not built-in
Ant libraries).
Ant scenario - Parameters tab
On the Parameters tab the buttons New,
Edit, and Delete can be used to set the
parameters which will be accessible as Ant properties in the Ant build
script.
Ant scenario - Output tab
On the Output tab the following details can be configured: