blob: 533bf9f8861767122493f3edd5eda80cfc410577 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//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 a plug-in</title>
</head>
<BODY BGCOLOR="#ffffff">
<h1>Running a plug-in</h1>
<p>As you develop your plug-in in the workspace, the incremental Java compiler
will compile your Java source code and place the <b> *.class</b> files into
the <b>bin</b> directory of your PDE project. When you are ready to test your
plug-in, you can launch a separate Eclipse application instance to test your
new plug-in.</p>
<p>The easiest way to launch an Eclipse applicaiton is via the link in the Testing
section of the plug-in manifest editor's Overview page. <b> </b>This will immediately
create a second Eclipse instance that will appear within seconds.</p>
<p>To gain full control over the way the run-time workbench is launched, select <b>Run
&gt; Run...</b> from the main menu bar. This will bring up the Launch Configuration
Dialog.</p>
<p align="center"> <img border="0" src="images/launch-dialog.png" alt="Eclipse Application - Main tab" ></p>
<p align="left"><b>Workspace data</b> field defines the workspace that will be
used by your application. The location of this runtime workspace must be different
from the workspace of your host instance.</p>
<p align="left">The default program to run is the<i> org.eclipse.sdk.ide </i>product.&nbsp;
Launching it will result in a second workbench instance coming up whose constituent
plug-ins are the workspace plug-ins and the plug-ins selected on the Target
Platform preference page.&nbsp; </p>
<p align="left">You can test your runtime workbench using the <b>JRE</b> of your
choice and does not have to be the same one against which your plug-ins compile
in the workspace.&nbsp; You can also specify any VM arguments that are appropriate
for your testing.</p>
<h2>Example:&nbsp; Running the Sample</h2>
<p>Press <b>Run</b>.&nbsp; Another platform instance should open. You will see a
top menu item called &quot;Sample Menu&quot; with a single &quot;Sample Action&quot; item. Selecting it should
pop up a dialog containing the phrase &quot;Hello, world&quot;.</p>
</body>
</html>