Context Launch Variables

Identifier: org.eclipse.debug.core.contextLaunchVariables

Since: 3.0

Description: This extension point provides a mechanism for defining context sensitive launch configuration variables. Context launch variables derive their value dynamically based on a client defined context (for example, the selected resource). Context launch variables can be used as attribute values in launch configurations that support variable expansion.

Configuration Markup:

   <!ELEMENT extension (variable*)>

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

   <!ATTLIST variable
     name          CDATA #REQUIRED
     expanderClass CDATA #REQUIRED
     description   CDATA #REQUIRED
   >

name - specifies a unique name for this variable.
expanderClass - specifies a Java class which implements org.eclipse.debug.core.variables.IVariableExpander, which is used to determine the value of the variable
description - specifies a human-readable description of this variable

Examples: The following is a definition of a context launch variable that expands to the name of the selected resource:

 <extension point="org.eclipse.debug.core.contextLaunchVariables">
   <variable 
      name="resource_name"
      expanderClass="com.example.ResourceNameExpander"
      description="The name of the selected resource">
   </variable>
 </extension>