Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
<html lang="en">
<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">

<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 in which the program will run. </p>
<p><img src="../../images/launchers/launcher_eclipse_main.png" alt="Main Tab" ></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. 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 set the location of the runtime workspace to be anywhere you like as long as the location is writable. Variable names can be used in the path to the runtime workspace location, thus allowing launch configuration to be sharable among team members. </p>
<p>The <strong>Clear</strong> option is useful if you want to test your plug-in in a fresh workspace or with a clean log file. This option is turned off by default, because Eclipse application workspaces typically contain useful data that does not need to be cleared from one launch to the next.</p>
<p>The <strong>Ask for confirmation before clearing</strong> option prompts the user before deleting the runtime workspace data. This option is turned on by default to prevent accidental loss of data from the test workspace. </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 config.ini file that is located in the <em>${target_home}/configuration</em> directory.  The ${target_home} 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 config.ini file that is located in the <em>${target_home}/configuration</em> directory. In the Eclipse SDK, the default application ID is <em>org.eclipse.ui.ide.workbench</em>. </p>
<p>The <strong>Run a product</strong> option is selected by default, because testing a product (a branded application) makes for a richer experience than testing a plain application. </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.
<h2>Java Runtime Environment</h2>
<p>You can test your plug-in against the <em>Java Runtime Environment</em> (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 Main 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>
  <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>

<p><img src="../../../images/ngrelr.png" alt="Related reference"></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="eclipse_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>

New to GrepCode? Check out our FAQ X