Lanceur (obsolète)
Identificateur :
org.eclipse.debug.core.launchers
Description :
Ce point
d'extension a été remplacé par celui launchConfigurationTypes. Les extensions de ce type
sont obsolètes en version 2.0 et donc ignorées. Ce point d'extension était
utilisé pour ajouter des lanceurs.
Un lanceur était chargé d'initier une session de débogage ou d'exécuter un
programme et d'enregistrer les résultats auprès du gestionnaire de
lanceurs.
Marques de configuration :
<!ELEMENT extension (launcher*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - identificateur qualifié complet du point
d'extension cible.
- id - identificateur facultatif de l'instance
d'extension.
- name - nom facultatif de l'instance d'extension.
<!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 - identificateur unique pouvant être utilisé pour référencer
ce lanceur.
- class - nom complet qualifié de la classe qui implémente
org.eclipse.debug.core.model.ILauncherDelegate.
- modes - liste de modes séparés par des virgules et que ce
lanceur prend en charge.
Les deux modes pris en charge sont exécution et débogage, comme défini
dans org.eclipse.debug.core.ILaunchManager.
Un lanceur doit pouvoir lancer dans les deux modes.
- label - libellé à utiliser pour le lanceur. Cet attribut
est utilisé avec l'interface utilisateur de débogage.
- wizard - nom complet qualifié de la classe qui implémente
org.eclipse.debug.ui.ILaunchWizard.
Cet attribut est utilisé avec l'interface de débogage.Un
lanceur peut ajouter un assistant qui permet aux utilisateurs de
configurer et de lancer des attributs spécifiques.
- public - détermine si un lanceur est visible de tous dans
l'interface de débogage.
Avec la valeur "true", le lanceur est disponible à partir de l'interface
de débogage ; il est proposé comme lanceur par défaut, les lancements
qu'il crée apparaissent dans son historique et il figure dans la liste
déroulante d'actions de la barre d'outils d'exécution/débogage.
- description - description du lanceur. En général,
utilisé uniquement si l'attribut wizard est spécifié.
- perspective - identificateur de la perspective activée si le
lancement réussit. Par défaut, il s'agit de l'identificateur de la
perspective de débogage. Cet attribut est utilisé avec l'interface
utilisateur de débogage.
- icon - chemin d'accès relatif d'une icône qui représente le
lanceur dans l'interface utilisateur spécifiée.
Exemples :
L'exemple
ci-dessous illustre le point d'extension d'un lanceur :
<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>
Dans cet exemple, le lanceur spécifié supporte les modes exécution et
débogage. Suite à un lancement réussi, l'interface de débogage passe sur
la perspective Java. Lorsque l'interface de débogage présente à
l'utilisateur la liste des lanceurs disponibles, "Lanceur d'exemples",
dont la description indique "Lance des programmes d'exemple", est l'un des
choix proposés et l'assistant désigné par
com.example.launchers.ui.ExampleLaunchWizard est utilisé pour
configurer les détails propres au lanceur.
Informations d'API :
La
valeur de l'attribut class doit correspondre au nom
qualifié complet d'une classe Java implémentant l'interface
org.eclipse.debug.core.ILauncherDelegate.
La valeur de l'attribut wizard doit être le nom qualifié
complet d'une classe Java qui implémente
org.eclipse.debug.ui.ILaunchWizard.
Copyright (c) 2000, 2003 IBM Corporation and others.
All rights reserved. Ce programme et les produits qui l'accompagnent sont
fournis sous licence v1.0 associée à cette distribution et disponibles à
l'adresse suivante :
http://www.eclipse.org/legal/cpl-v10.html