blob: 7de678dec91d07359bbc82f1373d1e388680bfb5 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>README Launcher Extension Points</title>
</head>
<body link="#0000FF" vlink="#800080">
<h1 align="center">Launcher</h1>
<p><b><i>Identifier: </i></b>org.eclipse.debug.core.launchers </p>
<p><b><i>Description: </i></b>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.</p>
<p><b><i>Configuration Markup:</i></b> </p>
<pre><tt> <!ATTLIST launcher</tt>
id CDATA #REQUIRED<tt>
class CDATA #REQUIRED</tt>
<tt> modes CDATA #REQUIRED
</tt> label CDATA #REQUIRED
wizard CDATA #IMPLIED
public CDATA #IMPLIED
description CDATA #IMPLIED
<tt>perspective CDATA #IMPLIED
></tt> </pre>
<ul>
<li><strong>id </strong>- a unique identifier that can be used to reference this
launcher.</li>
<li><b>class</b> - fully qualified name of the class that implements
<b>org.eclipse.debug.core.ILauncherDelegate</b>.</li>
<li><b>modes</b> - A comma separated list of modes this launcher supports. The two
supported modes are "run" and "debug" - as defined in <b>
org.eclipse.debug.core.ILaunchManager.</b>A launcher may be capable
of launching in one or both modes.</li>
<li><strong>label </strong>- a label to use for the launcher. This attribute is used by
the debug UI.</li>
<li><strong>wizard </strong>- fully qualified name of the class that implements
<b>org.eclipse.debug.ui.ILaunchWizard</b>. This attribute is used by
the debug UI. A launcher may contribute a wizard that allows users to configure and launch
specific attributes.</li>
<li><strong>public</strong> - whether a launcher is publically visible in the debug UI.
If "true", the launcher will be available from the debug UI - the
launcher will appear as a choice for a default launcher, launches created by this launcher
will appear in the launch history, and the launcher will be available from the drop-down
run/debug toolbar actions.</li>
<li><strong>description</strong> - a description of the launcher. Currently only
used if the <em>wizard</em> attribute is specified.</li>
<li><strong>perspective</strong> - the identifier of the perspective that will be
switched to on a successful launch. Default value is the identifier for the debug
perspective. This attribute is used by the debug UI.</li>
</ul>
<p><b><i>Examples:</i></b> </p>
<p>The following is an example of a launcher extension point: </p>
<pre><tt> <extension</tt>
<tt> point = "org.eclipse.debug.core.launchers"></tt>
<tt> <launcher</tt>
id = "com.example.ExampleLauncher"
<tt> class = "com.example.launchers.ExampleLauncher"</tt>
<tt> modes = "run, debug"
label = "Example Launcher"
wizard = "com.example.launchers.ui.ExampleLaunchWizard"
public = "true"
description = "Launches example programs"
perspective= "com.example.JavaPerspective"></tt>
<tt> </launcher></tt>
<tt> </extension></tt> </pre>
<p>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 <b>com.example.launchers.ui.ExampleLaunchWizard</b>
will be used to configure any launch specific details.</p>
<p><b><i>API Information: </i></b>Value of the attribute <b>class</b> must be a fully
qualified class name of a Java class that implements the interface <b>
org.eclipse.debug.core.ILauncherDelegate</b>. Value of the attribute
<strong>wizard</strong> must be a fully qualified class name of a Java class that
implements <b>org.eclipse.debug.ui.ILaunchWizard</b>.<br>
<br>
</p>
<p><a href="hglegal.htm"><img src="ngibmcpy.gif" alt="Copyright IBM Corp. 2000, 2001. All Rights Reserved."
border="0" width="195" height="12"></a></p>
</body>
</html>
|