Launch Groups

Identifier:

org.eclipse.debug.ui.launchGroups

Since:

2.1

Description:

This extension point provides support for defining a group of launch configurations to be viewed together in the launch configuration dialog, and support a launch history (recent and favorite launches).

Configuration Markup:

<!ELEMENT extension (launchGroup*)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

point - a fully qualified identifier of the target extension point
id - an optional identifier of the extension instance
name - an optional name of the extension instance

<!ELEMENT launchGroup EMPTY>

<!ATTLIST launchGroup

id CDATA #REQUIRED

mode IDREF #REQUIRED

category IDREF #IMPLIED

label CDATA #REQUIRED

image CDATA #REQUIRED

bannerImage CDATA #REQUIRED

public CDATA #IMPLIED

title CDATA #IMPLIED>

id - specifies a unique identifier for this launch group.
mode - specifies the launch mode associated with this group - i.e. run or debug.
category - specifies the category of launch configurations in this group. When unspecified, the category is null.
label - specifies a translatable label used to render this group.
image - specifies a plug-in relative path to an image used to render this group in trees, lists, tabs, etc.
bannerImage - specifies a plug-in relative path to an image used to render this group in a wizard or dialog banner area.
public - specifies whether this launch group is public and should be have a visible launch history tab in the debug preferences. The implied value is true, when not specified.
title - title to display in the launch wizard when this launch group is opened - for example "Select or configure an application to debug" (since 3.1)

Examples:

The following is an example of a launch group extension point:


 <extension point="org.eclipse.debug.ui.launchGroups">
  <launchGroup
     id="com.example.ExampleLaunchGroupId"
     mode="run"
     label="Run"
     image="icons\run.png"
     bannerImage="icons\runBanner.png">
  </launchGroup>
 </extension>

In the above example, the launch group will consist of all launch configurations with no category that support run mode.

Copyright (c) 2000, 2005 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