Launch Shortcuts

Identifier:

org.eclipse.pde.ui.launchShortcuts

Since:

3.3

Description:

This extension point is used to register a launching shortcut in a PDE editor. Launch shortcuts appear in the Testing section on the Overview page of the plug-in manifest editor. This allows clients to display in the editor shortcuts for their custom launch configurations or provide a shorcut to a profile mode for the existing Eclipse Application and OSGi Framework launch configurations.

Configuration Markup:

<!ELEMENT extension (shortcut+)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

<!ELEMENT shortcut EMPTY>

<!ATTLIST shortcut

id IDREF #REQUIRED

label CDATA #REQUIRED

mode (run|debug|profile)

osgi (true | false)

projectSpecific (true | false) >

id - the id of the corresponding org.eclipse.debug.ui.launchShortcuts extension which should be launched when the link is clicked.
label - human-readable label to be displayed in the editor.
mode - the mode in which to launch the shortcut. Permitted values are run, debug and profile.
osgi - If set to true, the link is displayed only if the plug-in manifest editor's presentation is set to show OSGi-related sections only, ie. when the Extensions and Extension Points pages are absent. If not specified, the value is assumed to be false.
projectSpecific - When true, this launch shortcut is only displayed in projects it has been associated with via IBundleProjectDescription. When unspecified, this value is assumed to be false. This attribute was added in the 3.6 release to support custom launch shortcuts in Manifest editors.

Examples:

The following is an example of the extension point:


   <extension
         point="org.eclipse.pde.ui.launchShortcuts">
      <shortcut
            id="org.eclipse.pde.ui.runtimeWorkbenchShortcut"
            label="Launch an Eclipse Runtime" 
            mode="run"
            osgi="false"/>
   </extension>

API Information:

The value of the attribute id must be the id of a defined org.eclipse.debug.ui.launchShortcuts extension. The class specified in the matching org.eclipse.debug.ui.launchShortcuts extension will be instantiated and its launch(IEditorPart, String) will be called to launch.

The value of the attribute mode must run, debug, or profile.

Supplied Implementation:

PDE supplies shortcut extensions to launch Eclipse applications and OSGi frameworks.

Copyright (c) 2007, 2013 IBM Corporation and others.
This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-v20.html/ SPDX-License-Identifier: EPL-2.0.