# 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 CDATA #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 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html.