blob: 2824054c5b9f34a6522bc32802bee2be161d607f [file] [log] [blame]
<!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>Target Platform Preferences</title>
<link rel="stylesheet" href="../../book.css" charset="ISO-8859-1" type="text/css">
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"> </script>
</head>
<body>
<h1>Target Platform Preferences</h1>
<p>The <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.pde.ui.TargetPlatformPreferencePage)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="Open the target platform preference page">
<strong>Window &gt; Preferences... &gt; Plug-in Development &gt; Target Platform </strong></a> preference page allows you to manage a set of target definitions and select one as the active target platform. A target definition consists of a set of plug-ins and environment settings. The active target platform is used to build and launch your workspace plug-ins.</p>
<p>The preference page will list all known target definitions. Some target definitions will be saved with Eclipse preferences, but this page will also display target definitions found in the workspace and external definition files that have been opened in the workspace. Definitions in the workspace will have their workspace location displayed in brown next to the name. The target definition that is currently being used as the active target platform will be checked, marked &quot;Active&quot; and be bolded. Change the active target platform by checking a different target definition. Any changes made on this page, including editing of target definitions, will not be saved until <strong>OK</strong> or <strong>Apply</strong> is pressed.</p>
<p><img src="../../images/preferences/target_preferences.png" alt="Target Platform Preference Page"></p>
<p>The default target platform points to the Eclipse application you are currently running. It is marked with a special Eclipse icon. You can restore the default target platform at any time by pressing the <strong>Restore Defaults</strong> button.</p>
<p><strong>Reload</strong> can only be pressed if the active target platform is currently selected and hasn't been changed while the preference page is open. Pressing it will force the target definition to resolve, refreshing the contents of any directory locations and downloading any out of date plug-ins in site locations. It is helpful to reload if you have changed something in your target platform outside of Eclipse. Any problems with the target will be displayed in a dialog.</p>
<p>Press <strong>Add</strong> to create a new target definition. The <a href="../target_shared/new_target_wizard.htm">New Target Wizard</a> will provide multiple options to create a new target.</p>
<p>Press <strong>Edit</strong> to edit the selected target definition. This will open the <a href="../target_shared/edit_target_wizard.htm">Edit Target Wizard</a> allowing you to edit all settings in the definition. You can also double click a target definition to edit it.</p>
<p>Pressing <strong>Remove</strong> will delete the selected target definitions when <strong>OK</strong> or <strong>Apply</strong> is pressed. If you remove a target definition that is stored in your workspace, it will be deleted.</p>
<p><strong>Move</strong> allows you to move a target definition stored in the Eclipse preferences to the workspace. The <a href="../target_shared/move_target_wizard.htm">Move Target Wizard</a> will have you choose a location in your workspace and a file name ending in &quot;.target&quot;. The new location will be displayed in grey beside the target name and will be applied when <strong>OK</strong> or <strong>Apply</strong> is pressed.</p>
<p><img src="../../images/preferences/target_locations_group.png" alt="Target Locations Group"></p>
<p>At the bottom of the page there is a <em>Locations</em> group. This table will display information about the currently selected target definition. It provides a quick way to see the contents of a target.</p>
<p>For up to the minute target troubleshooting help see the <a href="http://wiki.eclipse.org/PDE/Target_Definitions">Target Definitions Wiki Page</a>.</p>
<h3 class="related">Related references</h3>
<a href="./preferences.htm">PDE Preferences</a><br>
<a href="../target_shared/new_target_wizard.htm">New Target Wizard</a><br>
<a href="../target_shared/edit_target_wizard.htm">Edit Target Wizard</a><br>
<a href="../target_shared/move_target_wizard.htm">Move Target Wizard</a><br>
<a href="../editors/target_editor/target_editor.htm">Target Editor</a>
<h3 class="related">Related concepts</h3>
<a href="../../../concepts/target.htm">Target Definitions</a>
</body>
</html>