blob: 3818273f1d0acd664f7e42f77947fd4c18e255b6 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. 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>Ant view</title>
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"> </script>
</head>
<body bgcolor="#ffffff">
<h1> Ant view</h1>
<p class="Para">The Ant view provides a place to view Ant buildfiles and makes it
easy to execute a buildfile or a given target within a buildfile. You can add files
to the view and expand buildfiles to reveal the targets defined within them.</p>
<p>The pop-up menu for this view also allows you to open an editor on a
buildfile, execute the selected target or buildfile, and configure the launch
configuration used when executing.</p>
<p class="Para"> Here is what the Ant view looks like:</p>
<p class="Para"> <img align="top" border="0"
src="../images/ant-view.png" alt="Ant View" >
</p>
<div class="Topic">
<p>Like other views in the Workbench, the Ant view has its own
toolbar. Toolbar buttons are provided for adding buildfiles to the view and for
executing them.</p>
<p CLASS="Head">
To add the Ant view to the current perspective, click
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.ant.ui.views.AntView)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png">
<b>Window &gt; Show View &gt; Other... &gt; Ant &gt; Ant</b></a>.
</p>
<h2>Toolbar</h2>
<h3>Add Buildfiles</h3>
<p class="Para">This command prompts you to select buildfiles in the workspace to be added to the view.</p>
</div>
<div class="Topic">
<h3>Add Buildfiles with Search</h3>
<p class="Para">This command searches for buildfiles and adds them to the Ant view. You can
specify a file name pattern to search for and limit the scope of the search.</p>
</div>
<div class="Topic">
<h3>Hide Internal Targets</h3>
<p class="Para">This command filters the Ant view so that internal targets are not displayed. Internal
targets are targets with no description.</p>
</div>
<div class="Topic">
<h3>Run the Default Target of the Selected Buildfile</h3>
<p class="Para">This command runs the default target of the selected buildfile or the selected target.
The buildfile is executed using the launch configuration associated with the buildfile. Note that the
target execution is based on the selection in the view; the targets selected
in the launch configuration are ignored.</p>
</div>
<h3 class="Para">Remove Selected Buildfile</h3>
<p class="Para">This command removes the selected buildfiles from the view.</p>
<h3 class="Para">Remove All Buildfiles</h3>
<p class="Para">This command removes all buildfiles from the view.</p>
<h2 class="Para">Context menu </h2>
<p class="Para">The context menu contains a few actions in addition to the actions
available in the toolbar.&nbsp;&nbsp;</p>
<h3>Run Ant&nbsp;</h3>
<p class="Para"> This command launches an Ant build for the selected buildfile or for a specific selected target of the buildfile</p>
<h3>Run Ant...&nbsp;</h3>
<p class="Para"> This command brings up the launch configuration dialog to edit the
configuration associated with the selected buildfile.</p>
<div class="Topic">
<h3> Refresh Buildfiles</h3>
<p class="Para"> This command refreshes the contents of the view to reflect the current state of all the represented buildfiles.</p>
</div>
<h3>Open With &gt; &nbsp;</h3>
<p class="Para">This menu allows you to open an editor on the selected buildfile.</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-exttools.htm">External tools</a></p>
<p><img border="0" src="../images/ngrelt.png" alt="Related tasks"
><br>
<a href="../tasks/tasks-ant-running.htm">Running Ant buildfiles</a><br>
<a href="../tasks/tasks-ant-classpath.htm">Modifying the Ant classpath</a><br>
<a href="../tasks/tasks-ant-addtasksandtypes.htm">Adding new Ant tasks and types</a><br>
<a href="../tasks/tasks-ant-version.htm">Using a different version of Ant</a></p>
<p><img border="0" src="../images/ngrelr.png" alt="Related reference"
>
<br>
<a href="ref-antruntimeprefs.htm">Ant runtime preferences</a><br>
<a href="ref-anteditor.htm">Ant Editor</a><br>
<a href="ref-anticons.htm">External Tools and Ant icons</a>
</p>
</body>
</html>