Startprogramm (obsolet)
Kennung:
org.eclipse.debug.core.launchers
Beschreibung:
Dieser Erweiterungspunkt wurde durch den Erweiterungspunkt 'launchConfigurationTypes' ersetzt. Erweiterungen dieses Typs sind ab Release 2.0 obsolet und werden ignoriert. An diesem Erweiterungspunkt wurden früher Startprogramme ergänzt.
Ein Startprogramm übernahm die Einleitung einer Debugsitzung oder einer Programmausführung sowie die Registrierung des Ergebnisses im Startmanager.
Konfigurationsbefehle:
<!ELEMENT extension (launcher*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - Vollständig qualifizierte ID des Zielerweiterungspunkts
- id - Optionale ID des Erweiterungsexemplars
- name - Optionaler Name des Erweiterungsexemplars
<!ELEMENT launcher EMPTY>
<!ATTLIST launcher
id CDATA #REQUIRED
class CDATA #REQUIRED
modes CDATA #REQUIRED
label CDATA #REQUIRED
wizard CDATA #IMPLIED
public (true | false)
description CDATA #IMPLIED
perspective CDATA #IMPLIED
icon CDATA #IMPLIED>
- id - Eine eindeutige Kennung, mit der auf dieses Startprogramm verwiesen werden kann.
- class - Der vollständig qualifizierte Name einer Klasse,
die
org.eclipse.debug.core.model.ILauncherDelegate
implementiert.
- modes - Ein durch Kommata getrennte Liste der Moduswerte, die von diesem Startprogramm unterstützt werden.
Die beiden unterstützten Moduswert sind "run" und "debug" (wie in
org.eclipse.debug.core.ILaunchManager definiert).
Ein Startprogramm kann in der Lage sein, den Start in einem oder beiden Modi auszuführen.
- label - Eine Bezeichnung für das Startprogramm. Dieses Attribut wird von der Debugbenutzerschnittstelle verwendet.
- wizard - Der vollständig qualifizierte Name der Klasse, die
org.eclipse.debug.ui.ILaunchWizard implementiert.
Dieses Attribut wird von der Debugbenutzerschnittstelle verwendet. Ein Startprogramm kann einen Assistenten beisteuern, mit dessen Hilfe Benutzer spezifische Attribute konfigurieren und starten können.
- public - Dieses Attribut gibt an, ob ein Startprogramm in der Debugbenutzerschnittstelle allgemein zugänglich ist.
Ist es auf "true" gesetzt (das Startprogramm also in der Debugbenutzerschnittstelle verfügbar ist), wird das Startprogramm als Auswahlmöglichkeit für das Standardstartprogramm angezeigt, die durch dieses Startprogramm durchgeführten Startvorgänge werden im Startprotokoll aufgezeichnet, und das Startprogramm ist im Dropdown-Menü der Symbolleistenaktionen "Ausführen" bzw. "Debug" verfügbar.
- description - Eine Beschreibung des Startprogramms. Sie wird gegenwärtig nur bei Angabe des Attributs verwendet.
- perspective - Die Kennung der Perspektive, in die nach einem erfolgreichen Startverlauf umgeschaltet wird. Der Standardwert ist die Kennung für die Perspektive "Debug". Dieses Attribut wird von der Debugbenutzerschnittstelle verwendet.
- icon - Der relative Pfad eines Symbols, dass das Startprogramm in der Benutzerschnittstelle darstellt (sofern angegeben).
Beispiele:
Beispiel eines Erweiterungspunkts für ein Startprogramm:
<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>
Im oben dargestellten Beispiel unterstützt das angegebene
Startprogramm sowohl den Ausführungs- als auch den Debugmodus. Im Anschluss an einen erfolgreichen Startvorgang wechselt die Debugbenutzerschnittstelle in die Perspektive "Java". Sobald in der Debugbenutzerschnittstelle für den Benutzer eine Liste mit Startprogrammen zur Auswahl angezeigt wird, wird das Startprogramm "Example Launcher" als eine der Optionen mit der Beschreibung "Launches example programs" angezeigt, und alle startspezifischen Details werden mit dem Assistenten konfiguriert, der durch com.example.launchers.ui.ExampleLaunchWizard
angegeben ist.
API-Information:
Der Wert des Attributs class muss der vollständig qualifizierte Name einer Java-Klasse sein, die die Schnittstelle
org.eclipse.debug.core.ILauncherDelegate implementiert.
Der Wert des Attributs wizard muss der vollständig
qualifizierte Name einer Java-Klasse sein, die
org.eclipse.debug.ui.ILaunchWizard implementiert.
Copyright (c) 2000, 2003 IBM Corporation und Andere.
Alle Rechte vorbehalten. Dieses Programm und sein Begleitmaterial werden gemäß
den Bedingungen in der "Common Public License v1.0" zur Verfügung gestellt, die diese Verteilung
begleitet und unter
http://www.eclipse.org/legal/cpl-v10.html abgerufen werden kann.