blob: 9dce53719f4ecb3659f0a9cd64f54e7179b9c76b [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="en">
<HEAD>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
<title>Running Ant buildfiles</title>
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"> </script>
</HEAD>
<body>
<H1>Running Ant buildfiles</H1>
<p>To run an Ant buildfile in the Workbench:
</p>
<ol>
<li>In one of the navigation views, select an XML file.</li>
<li>From the file's pop-up menu, select <b>Run Ant...</b>. The launch configuration
dialog opens.</li>
<li>Select one or more targets from the <b>Targets</b> tab. The order
in which you select the items is the order in which they will run. The order
is displayed in the <b>Target execution order</b> box at the bottom of the tab.
You can change the order of the targets by clicking the <b>Order...</b> button.</li>
<li>(Optional) Configure options on the other tabs. For example, on the <b>Main</b> tab,
type any required arguments in the <b>Arguments</b> field.</li>
<li>Click <b>Run</b>.</li>
</ol>
<p>The Ant buildfile will run on the selected targets. Unless you disabled the <b>Capture
output</b> option on the <b>Main</b> tab, the console displays any applicable execution results
as the buildfile runs.
</p>
<p>These steps create a persisted launch configuration. The newly created configuration will
appear in the launch history under <b>Run &gt; External Tools</b> and will be available in the
launch configuration dialog which is opened by clicking
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.externalTools.commands.OpenExternalToolsConfigurations")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png" alt="command link">
<b>Run &gt; External Tools &gt; External Tools...</b></a>.
</p>
<p><img border="0" src="../images/ngrelc.png" alt="Related concepts" ><br>
<a href="../concepts/concepts-antsupport.htm">Ant support</a><br>
<a href="../concepts/concepts-22.htm">Builds</a><br>
<a href="../concepts/concepts-exttools.htm">External tools</a>
</p>
<p><img border="0" src="../images/ngrelt.png" alt="Related tasks" ><br>
<a href="../tasks/tasks-exttools-running.htm">Running external tools</a><br>
<a href="../tasks/tasks-ant-classpath.htm">Modifying the Ant classpath</a><br>
<a href="../tasks/tasks-ant-version.htm">Using a different version of Ant</a><br>
<a href="../tasks/tasks-ant-addtasksandtypes.htm">Adding new Ant tasks and types</a><br>
</p>
</body>
</HTML>