Launch Configuration Types

org.eclipse.debug.core.launchConfigurationTypes

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. As of 3.2 the types can also define a migration delegate that can be used to set resource mappings between projects and the launch configurations that launch them.

<!ELEMENT extension (launchConfigurationType+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT launchConfigurationType (fileExtension+)?>

<!ATTLIST launchConfigurationType

id                   CDATA #REQUIRED

delegate             CDATA #IMPLIED

modes                CDATA #IMPLIED

name                 CDATA #REQUIRED

public               (true | false)

category             CDATA #IMPLIED

sourcePathComputerId CDATA #IMPLIED

sourceLocatorId      CDATA #IMPLIED

migrationDelegate    CDATA #IMPLIED

delegateName         CDATA #IMPLIED

delegateDescription  CDATA #IMPLIED>


The fileExtension element is deprecated

<!ELEMENT fileExtension EMPTY>

<!ATTLIST fileExtension

extension CDATA #REQUIRED

default   (true | false) >

This element is no longer used. Instead, use the org.eclipse.debug.ui.launchShortcuts extension point.



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"

migrationDelegate=

"com.example.migrationDelegate"

sourceLocatorId=

"com.example.sourceLookupDirector"

sourcePathComputerId=

"com.example.sourcePathComputer"

delegateName=

"Example Application Launch Tooling"

delegateDescription=

"This example tooling will run or debug example code."

>

</launchConfigurationType>

</extension>

In the example above, the specified type of launch configuration supports both run and debug modes. The specified type also has an associated migration delegate, a source locator id, a source path computer, and launch delegate name and description.

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. The value of the attribute migrationDelegate must be a fully qualified name of a Java class that implements org.eclipse.debug.core.ILaunchConfigurationMigrationDelegate.