#
Launch Configuration Types

###### Identifier:

org.eclipse.debug.core.launchConfigurationTypes

###### Description:

This extension point provides a configurable mechanism for launching applications. Each launch configuration type has a name, supports one or more modes (run and/or debug), and specifies a delegate responsible for the implementation of launching an application.

###### Configuration Markup:

<!ELEMENT extension (launchConfigurationType*)>

<!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 launchConfigurationType (fileExtension+)>

<!ATTLIST launchConfigurationType

id CDATA #REQUIRED

delegate CDATA #REQUIRED

modes CDATA #REQUIRED

name CDATA #REQUIRED

public (true | false)

category CDATA #IMPLIED

sourcePathComputerId CDATA #IMPLIED

sourceLocatorId CDATA #IMPLIED>

- id - specifies a unique identifier for this launch configuration type.
- delegate - specifies the fully qualified name of the Java class that implements `ILaunchConfigurationDelegate`. Launch configuration instances of this type will delegate to instances of this class to perform launching.
- modes - specifies a comma-separated list of the modes this type of lauch configuration supports - "run" and/or "debug".
- name - specifies a human-readable name for this type of launch configuration.
- public - specifies whether this launch configuration type is accessible by users. Defaults to `true` if not specified.
- category - an optional attribute that specifies this launch configuration type's category. The default value is unspecified (`null`). Categories are client defined. This attribute was added in the 2.1 release.
- sourcePathComputerId - The unique identifier of a sourcePathComputer extension that is used to compute a default source lookup path for launch configurations of this type. This atttribute was added in the 3.0 release.
- 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. This atttribute was added in the 3.0 release.

<!ELEMENT fileExtension EMPTY>

<!ATTLIST fileExtension

extension CDATA #REQUIRED

default (true | false) >

- extension - specifies a file extension that this launch configuration type can be used for.
- default - specifies whether this launch configuration type should be the default launch configuration type for the specified file extension. Defaults to `false` if not specified.

###### Examples:

The following is an example of a launch configuration type extension point:

     <extension point="org.eclipse.debug.core.launchConfigurationTypes">
      <launchConfigurationType
       id="com.example.ExampleIdentifier"
       delegate="com.example.ExampleLaunchConfigurationDelegate"
       modes="run,debug"
       name="Example Application">
       <fileExtension extension="txt" default="true"/>
       <fileExtension extension="gif" default="false"/>
      </launchConfigurationType>
     </extension>

In the example above, the specified type of launch configuration supports both run and debug modes. The launch configuration is applicable to .txt and .gif files, and is the default launch configuration for .txt files.

###### 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