#
Launch Delegates

###### Identifier:

org.eclipse.debug.core.launchDelegates

###### Since:

3.0

###### Description:

This extension point provides a mechanism for contributing a launch delegate to an existing launch configuration type for one or more launch modes. Since launch modes are extensisble, it may be neccessary to contribute additional launch delegates to an existing launch configuration type. Each launch delegate is contributed for a specific launch configuration type. A launch delegate supports one or more launch modes, and specifies a delegate responsible for the implementation of launching.

###### Configuration Markup:

<!ELEMENT extension (launchDelegate*)>

<!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 launchDelegate EMPTY>

<!ATTLIST launchDelegate

id CDATA #REQUIRED

delegate CDATA #REQUIRED

modes CDATA #REQUIRED

type CDATA #REQUIRED

sourcePathComputerId CDATA #IMPLIED

sourceLocatorId CDATA #IMPLIED>

- id - specifies a unique identifier for this launch delegate.
- delegate - specifies the fully qualified name of the Java class that implements `ILaunchConfigurationDelegate`. Launch configuration instances of this delegate's type will delegate to instances of this class to perform launching.
- modes - specifies a comma-separated list of the modes this lauch delegate supports.
- type - identifier of an existing launch configuration type that this launch delegate is capable of launching.
- sourcePathComputerId - The unique identifier of a sourcePathComputer extension that is used to compute a default source lookup path for launch configurations of this type. Since 3.1, this attribute cab be specified in a launchDelegate extension when unspecified in the assocaited launchConfigurationType extension. Only one source path computer can be specified per launch configuration type.
- sourceLocatorId - The unique identifier of a sourceLocator extension that is used to create the source locator for sessions launched using launch configurations of this type. Since 3.1, this attribute cab be specified in a launchDelegate extension when unspecified in the assocaited launchConfigurationType extension. Only one source locater can be specified per launch configuration type.

###### Examples:

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

     <extension point="org.eclipse.debug.core.launchDelegates">
      <launchDelegate
       id="com.example.ExampleProfileDelegate"
       delegate="com.example.ExampleProfileDelegate"
       type="org.eclipse.jdt.launching.localJavaApplication"
       modes="profile">
      </launchDelegate>
     </extension>

In the example above, the specified launch delegate is contributed to launch Java applications in profile mode.

###### API Information:

Value of the attribute delegate must be a fully qualified name of a Java class that implements the interface org.eclipse.debug.core.model.ILaunchConfigurationDelegate.

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