Saving & Reusing Ant options
When we ran the
HelloWorld.xml Ant buildfile in the
the choice of targets, along with all other options in the launch configuration dialog were
saved in an entity called a 'launch configuration'. Launch configurations contain
all details necessary to run an Ant buildfile in a particular way. It is
perfectly valid to have multiple launch configurations associated with a single
Ant buildfile. Therefore, in addition to the launch configuration that was created in
the last step, specifying that our
HelloWorld.xml buildfile should execute the
"World" in that order, a second launch configuration could be created
for the same buildfile specifying different targets or just different ordering.
Creating multiple launch configurations in this manner allows you to quickly run
your Ant buildfile in any configuration by simply specifying the corresponding
- From the Workbench toolbar, select Run > External Tools > Open External Tools Dialog....
- The External Tools dialog opens and presents a choice of launch configurations
to view and edit. The launch configuration we created when we ran the
buildfile is selected in the tree at the left, and the tabs on the right show
the options for this launch configuration.
- At the top of the dialog, change the Name to
Hello World and Apply
- In the tree at left, bring up on the context menu on the selected launch
configuration and choose Duplicate, or select the Duplicate on the
toolbar above the tree. A copy of the launch configuration
for the Hello World buildfile is created,
(1) is appended to the name, and
the new launch configuration is selected in the tree.
- Rename the new configuration to
- In the Targets tab, click the Order... button, change the
order of the targets so that the
World target executes first, and Apply
- Click Run.
- As before, the
HelloWorld.xml buildfile runs and sends its output to the
This time however, because the targets were reversed, the output is reversed as well.
- Go back to the External Tools drop down in the toolbar.
Notice now that there are two entries in the history, one for
and one for
World Hello. In order to rerun the Ant buildfile so that it outputs
Hello World, just select this launch configuration in the history. To rerun
the launch configuration that outputs
World Hello, select this configuration
in the history.
Note: The history is ordered so that the most frequently
run configurations are at the top of the drop-down.
Creating Ant buildfiles
Editing Ant buildfiles
Running Ant buildfiles
Creating a project builder Ant buildfile
Ant buildfiles as project builders
Executing project builders
Non-Ant project builders
Stand-alone external tools