|
Lines 1-198
Link Here
|
| 1 |
<?xml version='1.0' encoding='UTF-8'?> |
1 |
<?xml version='1.0' encoding='UTF-8'?> |
| 2 |
<!-- Schema file written by PDE --> |
2 |
<!-- Schema file written by PDE --> |
| 3 |
<schema targetNamespace="org.eclipse.debug.core"> |
3 |
<schema targetNamespace="org.eclipse.debug.core"> |
| 4 |
<annotation> |
4 |
<annotation> |
| 5 |
<appInfo> |
5 |
<appInfo> |
| 6 |
<meta.schema plugin="org.eclipse.debug.core" id="launchDelegates" name="Launch Delegates"/> |
6 |
<meta.schema plugin="org.eclipse.debug.core" id="launchDelegates" name="Launch Delegates"/> |
| 7 |
</appInfo> |
7 |
</appInfo> |
| 8 |
<documentation> |
8 |
<documentation> |
| 9 |
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 extensible, 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. |
9 |
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 extensible, 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. |
| 10 |
</documentation> |
10 |
</documentation> |
| 11 |
</annotation> |
11 |
</annotation> |
| 12 |
|
12 |
|
| 13 |
<element name="extension"> |
13 |
<element name="extension"> |
| 14 |
<complexType> |
14 |
<complexType> |
| 15 |
<sequence> |
15 |
<sequence> |
| 16 |
<element ref="launchDelegate" minOccurs="1" maxOccurs="unbounded"/> |
16 |
<element ref="launchDelegate" minOccurs="1" maxOccurs="unbounded"/> |
| 17 |
</sequence> |
17 |
</sequence> |
| 18 |
<attribute name="point" type="string" use="required"> |
18 |
<attribute name="point" type="string" use="required"> |
| 19 |
<annotation> |
19 |
<annotation> |
| 20 |
<documentation> |
20 |
<documentation> |
| 21 |
a fully qualified identifier of the target extension point |
21 |
a fully qualified identifier of the target extension point |
| 22 |
</documentation> |
22 |
</documentation> |
| 23 |
</annotation> |
23 |
</annotation> |
| 24 |
</attribute> |
24 |
</attribute> |
| 25 |
<attribute name="id" type="string"> |
25 |
<attribute name="id" type="string"> |
| 26 |
<annotation> |
26 |
<annotation> |
| 27 |
<documentation> |
27 |
<documentation> |
| 28 |
an optional identifier of the extension instance |
28 |
an optional identifier of the extension instance |
| 29 |
</documentation> |
29 |
</documentation> |
| 30 |
</annotation> |
30 |
</annotation> |
| 31 |
</attribute> |
31 |
</attribute> |
| 32 |
<attribute name="name" type="string"> |
32 |
<attribute name="name" type="string"> |
| 33 |
<annotation> |
33 |
<annotation> |
| 34 |
<documentation> |
34 |
<documentation> |
| 35 |
an optional name of the extension instance |
35 |
an optional name of the extension instance |
| 36 |
</documentation> |
36 |
</documentation> |
| 37 |
</annotation> |
37 |
</annotation> |
| 38 |
</attribute> |
38 |
</attribute> |
| 39 |
</complexType> |
39 |
</complexType> |
| 40 |
</element> |
40 |
</element> |
| 41 |
|
41 |
|
| 42 |
<element name="launchDelegate"> |
42 |
<element name="launchDelegate"> |
| 43 |
<annotation> |
43 |
<annotation> |
| 44 |
<appInfo> |
44 |
<appInfo> |
| 45 |
<meta.element labelAttribute="name"/> |
45 |
<meta.element labelAttribute="name"/> |
| 46 |
</appInfo> |
46 |
</appInfo> |
| 47 |
</annotation> |
47 |
</annotation> |
| 48 |
<complexType> |
48 |
<complexType> |
| 49 |
<sequence minOccurs="0" maxOccurs="unbounded"> |
49 |
<sequence minOccurs="0" maxOccurs="unbounded"> |
| 50 |
<element ref="modeCombination" minOccurs="1" maxOccurs="unbounded"/> |
50 |
<element ref="modeCombination" minOccurs="1" maxOccurs="unbounded"/> |
| 51 |
</sequence> |
51 |
</sequence> |
| 52 |
<attribute name="id" type="string" use="required"> |
52 |
<attribute name="id" type="string" use="required"> |
| 53 |
<annotation> |
53 |
<annotation> |
| 54 |
<documentation> |
54 |
<documentation> |
| 55 |
specifies a unique identifier for this launch delegate. |
55 |
specifies a unique identifier for this launch delegate. |
| 56 |
</documentation> |
56 |
</documentation> |
| 57 |
</annotation> |
57 |
</annotation> |
| 58 |
</attribute> |
58 |
</attribute> |
| 59 |
<attribute name="name" type="string"> |
59 |
<attribute name="name" type="string"> |
| 60 |
<annotation> |
60 |
<annotation> |
| 61 |
<documentation> |
61 |
<documentation> |
| 62 |
A human readable name for this delegate. This attribute was added in the 3.3. release. |
62 |
A human readable name for this delegate. This attribute was added in the 3.3. release. |
| 63 |
<p> |
63 |
<p> |
| 64 |
An example of a 'human readable name' would be something like (in the case of the default java application delegate): Eclipse JDT Java Tooling |
64 |
An example of a 'human readable name' would be something like (in the case of the default java application delegate): Eclipse JDT Java Tooling |
| 65 |
</p> |
65 |
</p> |
| 66 |
<p> |
66 |
<p> |
| 67 |
<strong>EXPERIMENTAL</strong>. This attribute has been added as |
67 |
<strong>EXPERIMENTAL</strong>. This attribute has been added as |
| 68 |
part of a work in progress. There is no guarantee that this API will |
68 |
part of a work in progress. There is no guarantee that this API will |
| 69 |
remain unchanged during the 3.3 release cycle. Please do not use this API |
69 |
remain unchanged during the 3.3 release cycle. Please do not use this API |
| 70 |
without consulting with the Platform/Debug team. |
70 |
without consulting with the Platform/Debug team. |
| 71 |
</p> |
71 |
</p> |
| 72 |
</documentation> |
72 |
</documentation> |
| 73 |
<appInfo> |
73 |
<appInfo> |
| 74 |
<meta.attribute translatable="true"/> |
74 |
<meta.attribute translatable="true"/> |
| 75 |
</appInfo> |
75 |
</appInfo> |
| 76 |
</annotation> |
76 |
</annotation> |
| 77 |
</attribute> |
77 |
</attribute> |
| 78 |
<attribute name="delegate" type="string" use="required"> |
78 |
<attribute name="delegate" type="string" use="required"> |
| 79 |
<annotation> |
79 |
<annotation> |
| 80 |
<documentation> |
80 |
<documentation> |
| 81 |
specifies the fully qualified name of the Java class that implements <code>ILaunchConfigurationDelegate</code>. |
81 |
specifies the fully qualified name of the Java class that implements <code>ILaunchConfigurationDelegate</code>. |
| 82 |
Launch configuration instances of this delegate's type will delegate to instances of this class to perform launching. |
82 |
Launch configuration instances of this delegate's type will delegate to instances of this class to perform launching. |
| 83 |
</documentation> |
83 |
</documentation> |
| 84 |
<appInfo> |
84 |
<appInfo> |
| 85 |
<meta.attribute kind="java" basedOn="org.eclipse.debug.core.model.ILaunchConfigurationDelegate"/> |
85 |
<meta.attribute kind="java" basedOn="org.eclipse.debug.core.model.ILaunchConfigurationDelegate"/> |
| 86 |
</appInfo> |
86 |
</appInfo> |
| 87 |
</annotation> |
87 |
</annotation> |
| 88 |
</attribute> |
88 |
</attribute> |
| 89 |
<attribute name="modes" type="string"> |
89 |
<attribute name="modes" type="string"> |
| 90 |
<annotation> |
90 |
<annotation> |
| 91 |
<documentation> |
91 |
<documentation> |
| 92 |
A comma-separated list of the launch modes this delegate supports. |
92 |
A comma-separated list of the launch modes this delegate supports. |
| 93 |
|
93 |
|
| 94 |
<p> |
94 |
<p> |
| 95 |
New in 3.3: the comma seperated list of modes provided here, instead of via the modeCombination sub elements, will result in a set being created for each mode individually with no other combinations. |
95 |
New in 3.3: the comma seperated list of modes provided here, instead of via the modeCombination sub elements, will result in a set being created for each mode individually with no other combinations. For example specifying: 'run,debug' will result in a set of two elements [[run], [debug]] (where run and debug are each in their own set). |
| 96 |
</p> |
96 |
</p> |
| 97 |
</documentation> |
97 |
<p> |
| 98 |
</annotation> |
98 |
This attribute can be used in conjunction with modeCombination contributions. It is however, desirable to provide one or the other and not both (either a comma seperated listing in the modes attribute, or modeCombinations). Specifying 'run,debug' in the modes attribute is analogous to specifying two modeCombination contributions, one for 'run' and another for 'debug'. |
| 99 |
</attribute> |
99 |
</p> |
| 100 |
<attribute name="type" type="string"> |
100 |
</documentation> |
| 101 |
<annotation> |
101 |
</annotation> |
| 102 |
<documentation> |
102 |
</attribute> |
| 103 |
identifier of an existing launch configuration type that this launch delegate is capable of launching. |
103 |
<attribute name="type" type="string"> |
| 104 |
</documentation> |
104 |
<annotation> |
| 105 |
</annotation> |
105 |
<documentation> |
| 106 |
</attribute> |
106 |
identifier of an existing launch configuration type that this launch delegate is capable of launching. |
| 107 |
<attribute name="sourcePathComputerId" type="string"> |
107 |
</documentation> |
| 108 |
<annotation> |
108 |
</annotation> |
| 109 |
<documentation> |
109 |
</attribute> |
| 110 |
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. |
110 |
<attribute name="sourcePathComputerId" type="string"> |
| 111 |
</documentation> |
111 |
<annotation> |
| 112 |
</annotation> |
112 |
<documentation> |
| 113 |
</attribute> |
113 |
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. |
| 114 |
<attribute name="sourceLocatorId" type="string"> |
114 |
</documentation> |
| 115 |
<annotation> |
115 |
</annotation> |
| 116 |
<documentation> |
116 |
</attribute> |
| 117 |
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 can be specified in a launchDelegate extension when unspecified in the assocaited launchConfigurationType extension. Only one source locater can be specified per launch configuration type. |
117 |
<attribute name="sourceLocatorId" type="string"> |
| 118 |
</documentation> |
118 |
<annotation> |
| 119 |
</annotation> |
119 |
<documentation> |
| 120 |
</attribute> |
120 |
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 can be specified in a launchDelegate extension when unspecified in the assocaited launchConfigurationType extension. Only one source locater can be specified per launch configuration type. |
| 121 |
</complexType> |
121 |
</documentation> |
| 122 |
</element> |
122 |
</annotation> |
| 123 |
|
123 |
</attribute> |
| 124 |
<element name="modeCombination"> |
124 |
<attribute name="delegateDescription" type="string"> |
| 125 |
<annotation> |
125 |
<annotation> |
| 126 |
<documentation> |
126 |
<documentation> |
| 127 |
This element represents a collection of mode combinations that this delegate can launch. Each modeCombination attribute is a comma seperated list specifying a combination of modes the delegate supports. For example, a delegate that supports debugging, profiling and code coverage might have a modeCombination of consisting of debug, profile, and coverage. This element was added in the 3.3 release. EXPERIMENTAL. |
127 |
This attribute provides a description of this launch delegate i.e. what it does and what tooling it is assciated with. This attribute was added in the 3.3 release. EXPERIMENTAL. |
| 128 |
</documentation> |
128 |
</documentation> |
| 129 |
</annotation> |
129 |
</annotation> |
| 130 |
<complexType> |
130 |
</attribute> |
| 131 |
<attribute name="modes" type="string" use="required"> |
131 |
</complexType> |
| 132 |
<annotation> |
132 |
</element> |
| 133 |
<documentation> |
133 |
|
| 134 |
a comma seperated list specifying a combination of modes the associated delegate can launch. This attribute was added in the 3.3 release. EXPERIMENTAL. |
134 |
<element name="modeCombination"> |
| 135 |
</documentation> |
135 |
<annotation> |
| 136 |
</annotation> |
136 |
<documentation> |
| 137 |
</attribute> |
137 |
This element represents a collection of mode combinations that this delegate can launch. Each modeCombination attribute is a comma seperated list specifying a combination of modes the delegate supports. For example, a delegate that supports debugging, profiling and code coverage might have a modeCombination of consisting of debug, profile, and coverage. This element was added in the 3.3 release. EXPERIMENTAL. |
| 138 |
</complexType> |
138 |
</documentation> |
| 139 |
</element> |
139 |
</annotation> |
| 140 |
|
140 |
<complexType> |
| 141 |
<annotation> |
141 |
<attribute name="modes" type="string" use="required"> |
| 142 |
<appInfo> |
142 |
<annotation> |
| 143 |
<meta.section type="since"/> |
143 |
<documentation> |
| 144 |
</appInfo> |
144 |
a comma seperated list specifying a combination of modes the associated delegate can launch. This attribute was added in the 3.3 release. EXPERIMENTAL. |
| 145 |
<documentation> |
145 |
|
| 146 |
3.0 |
146 |
<p> |
| 147 |
</documentation> |
147 |
Unlike the modes attribute of the main definition, this comma seperated listing is taken to be one set inclusively. For example: a modeCombination of 'profile,debug' would result in a single set of modes [[profile, debug]] and not a set with two distinct entries for each of profile and debug [[profile], [debug]] (unlike the other modes attribute from the main definition). |
| 148 |
</annotation> |
148 |
</p> |
| 149 |
|
149 |
</documentation> |
| 150 |
<annotation> |
150 |
</annotation> |
| 151 |
<appInfo> |
151 |
</attribute> |
| 152 |
<meta.section type="examples"/> |
152 |
</complexType> |
| 153 |
</appInfo> |
153 |
</element> |
| 154 |
<documentation> |
154 |
|
| 155 |
The following is an example of a launch delegate extension point: |
155 |
<annotation> |
| 156 |
|
156 |
<appInfo> |
| 157 |
<p> |
157 |
<meta.section type="since"/> |
| 158 |
<pre> |
158 |
</appInfo> |
| 159 |
<extension point="org.eclipse.debug.core.launchDelegates"> |
159 |
<documentation> |
| 160 |
<launchDelegate |
160 |
3.0 |
| 161 |
id="com.example.ExampleProfileDelegate" |
161 |
</documentation> |
| 162 |
delegate="com.example.ExampleProfileDelegate" |
162 |
</annotation> |
| 163 |
type="org.eclipse.jdt.launching.localJavaApplication" |
163 |
|
| 164 |
name="Eclipse JDT Java Profile Tooling"> |
164 |
<annotation> |
| 165 |
</launchDelegate> |
165 |
<appInfo> |
| 166 |
<modeCombination modes="run, profile"></modeCombination> |
166 |
<meta.section type="examples"/> |
| 167 |
<modeCombination modes="debug, profile, coverage"></modeCombination> |
167 |
</appInfo> |
| 168 |
</extension> |
168 |
<documentation> |
| 169 |
</pre> |
169 |
The following is an example of a launch delegate extension point: |
| 170 |
</p> |
170 |
|
| 171 |
|
171 |
<p> |
| 172 |
In the example above, the specified launch delegate is contributed to launch Java applications in profile mode. The delegate supports mixed mode launching. The delegate supports profiling when launching in run or debug mode, with code coverage in debug mode only. |
172 |
<pre> |
| 173 |
</documentation> |
173 |
<extension point="org.eclipse.debug.core.launchDelegates"> |
| 174 |
</annotation> |
174 |
<launchDelegate |
| 175 |
|
175 |
id="com.example.ExampleProfileDelegate" |
| 176 |
<annotation> |
176 |
delegate="com.example.ExampleProfileDelegate" |
| 177 |
<appInfo> |
177 |
type="org.eclipse.jdt.launching.localJavaApplication" |
| 178 |
<meta.section type="apiInfo"/> |
178 |
name="Eclipse JDT Java Profile Tooling"> |
| 179 |
</appInfo> |
179 |
</launchDelegate> |
| 180 |
<documentation> |
180 |
<modeCombination modes="run, profile"></modeCombination> |
| 181 |
Value of the attribute <b>delegate</b> must be a fully qualified name of a Java class that implements the interface <b>org.eclipse.debug.core.model.ILaunchConfigurationDelegate</b>. |
181 |
<modeCombination modes="debug, profile, coverage"></modeCombination> |
| 182 |
</documentation> |
182 |
</extension> |
| 183 |
</annotation> |
183 |
</pre> |
| 184 |
|
184 |
</p> |
| 185 |
<annotation> |
185 |
|
| 186 |
<appInfo> |
186 |
In the example above, the specified launch delegate is contributed to launch Java applications in profile mode. The delegate supports mixed mode launching. The delegate supports profiling when launching in run or debug mode, with code coverage in debug mode only. |
| 187 |
<meta.section type="copyright"/> |
187 |
</documentation> |
| 188 |
</appInfo> |
188 |
</annotation> |
| 189 |
<documentation> |
189 |
|
| 190 |
Copyright (c) 2000, 2005 IBM Corporation and others.<br> |
190 |
<annotation> |
| 191 |
All rights reserved. This program and the accompanying materials are made |
191 |
<appInfo> |
| 192 |
available under the terms of the Eclipse Public License v1.0 which |
192 |
<meta.section type="apiInfo"/> |
| 193 |
accompanies this distribution, and is available at |
193 |
</appInfo> |
| 194 |
<a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a> |
194 |
<documentation> |
| 195 |
</documentation> |
195 |
Value of the attribute <b>delegate</b> must be a fully qualified name of a Java class that implements the interface <b>org.eclipse.debug.core.model.ILaunchConfigurationDelegate</b>. |
| 196 |
</annotation> |
196 |
</documentation> |
| 197 |
|
197 |
</annotation> |
| 198 |
</schema> |
198 |
|
|
|
199 |
<annotation> |
| 200 |
<appInfo> |
| 201 |
<meta.section type="copyright"/> |
| 202 |
</appInfo> |
| 203 |
<documentation> |
| 204 |
Copyright (c) 2000, 2005 IBM Corporation and others.<br> |
| 205 |
All rights reserved. This program and the accompanying materials are made |
| 206 |
available under the terms of the Eclipse Public License v1.0 which |
| 207 |
accompanies this distribution, and is available at |
| 208 |
<a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a> |
| 209 |
</documentation> |
| 210 |
</annotation> |
| 211 |
|
| 212 |
</schema> |