Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2006, 2009. 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">
<title>Main Tab</title>
<link href="../../book.css" rel="stylesheet" type="text/css">
</head>

<body>
<h1>Main Tab</h1>
<p>The <strong>Main Tab</strong> allows you to customize important settings of the launch configuration, including the location of the runtime workspace, the program to run and the Java Runtime Environment (JRE). </p>
<p><img src="../../images/launchers/launcher_junit_main.png" alt="JUnit Plug-in Main" ></p>

<h2>Workspace Data</h2>
<p>The<strong> Workspace Data</strong> location is the directory on disk that will contain all the work and metadata (e.g. preferences, etc.) for the runtime Eclipse application you are testing. This location must, of course, be different than the location of your host workspace, since you should be testing your plug-in in a sandbox. </p>
<p>By default, the location of the runtime workspace is set by PDE to have a unique name based on the launch configuration name and to be a sibling of the host workspace directory. You can specify any location for the runtime workspace provided that the new location is writable. Variable names can be used in the path to the runtime workspace location in order to make the launch configuration sharable among team members. </p>
<p>The <strong>Clear</strong> and <strong>Workspace</strong> options are selected by default because it is recommended to do test runs within a fresh workspace. </p>
<p>The <strong>Ask for confirmation before clearing</strong> option prompts the user before deleting the runtime workspace data. This option is turned off by default, because the workspaces for <em>JUnit Plug-in Test</em> runs are typically not valuable. </p>
<p>Please note that the defaults for the <strong>Clear</strong> and <strong>Ask for confirmation before clearing</strong> options in this launch configuration are opposite to the defaults on the <a href="eclipse_main.htm">Main tab</a> of a regular Eclipse Application launch configuration. </p>

<h2>Program To Run</h2>
<p>The <strong>Program to Run</strong> section is where you specify the product or application to test. </p>
<p>The product combo box is populated with the IDs of all products (<em>org.eclipse.core.runtime.products</em> extensions) defined in the workspace and target plug-ins. The product ID that is initially selected is the default product as specified by the <strong>eclipse.product</strong> key in the <em>config.ini</em> file located in the <em>${target_home}/configuration</em> directory.  The <em>${target_home}</em> variable refers to the location of the target platform as specified on the <strong>Windows &gt; Preferences... &gt; Plug-in Development &gt; Target Platform</strong> preference page. In the Eclipse SDK, the default product ID is <em>org.eclipse.sdk.ide</em>.</p>
<p>The application combo box is populated with the IDs of all applications (<em>org.eclipse.core.runtime.applications</em> extensions) defined in the workspace and target plug-ins. The application ID that is initially selected is the default application as specified by the <strong>eclipse.application</strong> key in the <em>config.ini</em> file that is located in the <em>${target_home}/configuration directory</em>. In the Eclipse SDK, the default application ID is <em>org.eclipse.ui.ide.workbench</em>. </p>
<p>Some tests neither require a user interface nor a workbench and can therefore be run in headless mode. The <em>JUnit Plug-in Test</em> launcher provides such a mode in the application combo box.</p>
<p><img src="../../images/launchers/launcher_junit_headless.PNG" alt="headless" > </p>

<h2>Java Executable</h2>
<p>The <strong>Java Executable</strong> option allows you to specify the executable to run the Eclipse Application with. For example, on <em>Windows</em> you can override the default executable, <em>javaw.exe</em>, with <em>java.exe</em> if desired. </p>

<h2>Java Runtime Environment</h2>
<p>You can test your plug-in against the JRE of your choice; furthermore, this runtime JRE does not necessarily have to be the same JRE (with associated SDK) utilized to compile the workspace plug-ins. </p>
<p>The <strong>Runtime JRE</strong> combo box is populated with all the JREs listed on the <strong>Windows &gt; Preferences.... &gt; Java &gt; Installed JREs</strong> preference page. You can dynamically add more JREs to the list of installed JREs by pressing the <strong>Installed JREs...</strong> button, which will open the <strong>Installed JREs</strong> preference page. </p>

<h2>Bootstrap Entries</h2>
<p>Launching the host Eclipse instance typically involves a native launcher executable, which in turn calls an <em>org.eclipse.equinox.launcher.Main</em> class to start the bootstrapping process. The <em>Main</em> class  is located in the bundle named <em>org.eclipse.equinox.launcher</em>. </p>
<p>Launching a runtime Eclipse application bypasses the native executable and calls the <em>Main</em> class directly, as you would run any regular Java application. Therefore, PDE computes the location of the <em>Main</em> class and implicitly adds it to the classpath of the launch configuration.</p>
<p>Certain profilers require some native libraries to be on the classpath of the launch configuration as well. The <strong>Bootstrap Entries</strong> field allows you to specify and append such additional locations to the classpath.</p>


<p>For more information on running Eclipse, refer to the following documents:</p>
<ul>
  <li><a href="../../../../org.eclipse.platform.doc.user/tasks/running_eclipse.htm">Running Eclipse</a></li>
  <li><a href="../../../../org.eclipse.platform.doc.isv/reference/misc/runtime-options.html">Eclipse Runtime Options </a></li>
</ul>

<p><img src="../../../images/ngrelr.png" alt="Related reference"></p>
<p>
  <a href="eclipse_application_launcher.htm">Eclipse Application Launcher</a><br>
  <a href="junit_launcher.htm">JUnit Plug-in Test Launcher</a><br>
  <a href="equinox_launcher.htm">OSGi Framework Launcher</a><br>
  <a href="junit_test.htm">Junit Launcher Test Tab</a><br>
  <a href="junit_main.htm">Main Tab</a><br>
  <a href="arguments.htm">Arguments Tab</a><br>
  <a href="plugins.htm">Plug-ins Tab</a><br>
  <a href="configuration.htm">Configuration Tab</a><br>
  <a href="tracing.htm">Tracing Tab</a><br>
  <a href="environment.htm">Environment Tab</a><br>
  <a href="common.htm">Common Tab</a>
</p>

</body>
</html>
New to GrepCode? Check out our FAQ X