Launcher

Identifier: org.eclipse.debug.core.launchers

Description: This extension point allows tools to contribute launchers. A launcher is responsible for initiating a debug session or running a program and registering the result with the launch manager.

Configuration Markup:

   <!ATTLIST launcher 
      id		CDATA #REQUIRED
      class		CDATA #REQUIRED
      modes		CDATA #REQUIRED
      label		CDATA #REQUIRED
      wizard		CDATA #IMPLIED
      public		CDATA #IMPLIED
      description	CDATA #IMPLIED
      perspective	CDATA #IMPLIED
   > 

Examples:

The following is an example of a launcher extension point:

   <extension 
      point = "org.eclipse.debug.core.launchers"> 
         <launcher 
             id = "com.example.ExampleLauncher"
             class = "com.example.launchers.ExampleLauncher" 
             modes = "run, debug"
  	     label = "Example Launcher"
	     wizard = "com.example.launchers.ui.ExampleLaunchWizard"     
	     public = "true"
	     description = "Launches example programs"
	     perspective= "com.example.JavaPerspective">  
         </launcher> 
   </extension> 

In the example above, the specified launcher supports both run and debug modes. Following a successful launch, the debug UI will change to the Java perspective. When the debug UI presents the user with a list of launchers to choose from, "Example Launcher" will appear as one of the choices with the "Launches example programs" as the description, and the wizard specified by com.example.launchers.ui.ExampleLaunchWizard will be used to configure any launch specific details.

API Information: Value of the attribute class must be a fully qualified class name of a Java class that implements the interface org.eclipse.debug.core.ILauncherDelegate. Value of the attribute wizard must be a fully qualified class name of a Java class that implements org.eclipse.debug.ui.ILaunchWizard.

Copyright IBM Corporation 2000