blob: 189e467e86c48915e90ad7556ba23b109641db56 (
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
96
97
98
99
100
101
|
<!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
icon 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>icon </strong>- a relative path for an icon that will be used to visually
represent the launcher. If omitted, no icon will be used for this launcher.
The path is relative to the location of the plugin.xml file of the contributing
plug-in.</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"
icon = "icons/exampleLauncher.gif"
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>
|
