| <!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>Running external tools</title> |
| <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"> </script> |
| </HEAD> |
| |
| <BODY BGCOLOR="#ffffff"> |
| <H1>Running external tools</H1> |
| |
| <p>The Workbench provides a mechanism for running tools that are not part of it. |
| To configure an external tool: |
| </p> |
| |
| <ol> |
| <li>Click <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.externalTools.commands.OpenExternalToolsConfigurations")'> |
| <img src="PLUGINS_ROOT/org.eclipse.help/command_link.png"> |
| <b>Run > External Tools > External Tools...</b></a>. |
| </li> |
| <li>Select the Program configuration</li> |
| <li>Click the <b>New</b> button.</li> |
| <li>Enter a name for your external tool (for example, My External Tool).</li> |
| <li>Click the <b>Browse File System</b> button.</li> |
| <li>Find the tool you want to run (for example, on Windows it is usually a file |
| with the extension .exe or .bat).</li> |
| <li>(Optional) In the <b>Arguments</b> field enter the necessary arguments |
| for the tool.</li> |
| <li>(Optional)In the <b>Working directory</b> field enter the working directory |
| for the tool.</li> |
| <li>Click <b>Run</b>.</li> |
| </ol> |
| |
| <p>These steps create a persisted launch configuration. The newly created configuration will |
| appear in the launch history under <b>Run > 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"> |
| <b>Run > External Tools > External Tools...</b></a>. |
| </p> |
| |
| <p>It is also possible to set up and run an external tool to build a project. |
| </p> |
| |
| <ol> |
| <li>Select the desired project.</li> |
| <li>From its pop-up menu choose <b>Properties</b>.</li> |
| <li>Click <b>Builders</b> from the list, and configure the tool as described above.</li> |
| </ol> |
| |
| <P><img border="0" src="../images/ngrelc.png" alt="Related concepts" ><br> |
| <a href="../concepts/concepts-exttools.htm">External tools</a><br> |
| </P> |
| |
| <p><img border="0" src="../images/ngrelt.png" alt="Related tasks" ><br> |
| <a href="./tasks-ant-running.htm">Running Ant buildfiles</a><br> |
| </p> |
| |
| |
| |
| </BODY> |
| </HTML> |