Utilità di avvio (obsoleto)
Identificativo:
org.eclipse.debug.core.launchers
Descrizione:
Questo punto di estensione è stato sostituito da
launchConfigurationTypes. Le estensioni di questo tipo sono obsolete a partire
dalla versione 2.0 e sono ignorate. Questo punto di estensione era utilizzato
per il contributo alle utilità di avvio.
Un'utilità di avvio era responsabile dell'avvio di una sessione di debug o
dell'esecuzione di un programma, nonché della registrazione dei risultati
attraverso la gestione dell'avvio.
Tag di configurazione:
<!ELEMENT extension (launcher*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - identificativo completo del punto di estensione di
destinazione
- id - identificativo dell'istanza dell'estensione
- name - nome dell'istanza dell'estensione facoltativo
<!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 - un identificativo univoco che può essere utilizzato per fare riferimento a questa
utilità di avvio.
- class - nome completo della classe che implementa
org.eclipse.debug.core.model.ILauncherDelegate.
- modes - un elenco delle modalità, separate mediante virgola, supportate da questa utilità di avvio.
Le due
modalità supportate sono "run" e "debug", come definito in org.eclipse.debug.core.ILaunchManager.
Una utilità di avvio può gestire entrambe le modalità.
- label - un'etichetta da utilizzare per l'utilità di avvio. Questo attributo viene utilizzato dall'interfaccia
utente per il debug.
- wizard - nome completo della classe che implementa org.eclipse.debug.ui.ILaunchWizard.
Questo attributo viene utilizzato dall'interfaccia
utente per il debug. Una utilità di avvio potrebbe fornire una procedura guidata che consente agli utenti di
configurare e avviare specifici attributi.
- public - indica se una utilità di avvio è visibile pubblicamente nell'interfaccia utente per il debug.
Se il valore è "true", l'utilità di avvio sarà
disponibile dall'interfaccia utente per il debug; l'utilità di avvio apparirà
come una scelta per l'utilità di avvio predefinita, gli avvii creati mediante
questa utilità di avvio appariranno nella cronologia degli avvii e l'utilità di
avvio stessa sarà disponibile nelle azioni Esegui/Debug della barra degli
strumenti.
- description - breve descrizione dell'utilità di avvio. Attualmente
è utilizzata solo se è specificato l'attributo di procedura guidata.
- perspective - l'identificativo della prospettiva che verrà attivata
dopo un avvio eseguito correttamente. Il valore predefinito è l'identificativo della prospettiva debug. Questo attributo viene utilizzato dall'interfaccia
utente per il debug.
- icon - un percorso relativo all'icona che verrà utilizzata per
rappresentare l'utilità di avvio nell'interfaccia utente, se specificata.
Esempi:
Di seguito viene riportato un
esempio di punto di estensione per l'utilità di avvio:
<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>
Nell'esempio precedente, l'utilità di avvio specificata supporta entrambe le
modalità, run e debug. Dopo un avvio con esito positivo, l'interfaccia utente per il debug assumerà
l'aspetto di una prospettiva Java. Quando l'interfaccia utente per il debug
presenta all'utente un elenco da cui selezionare le utilità di avvio,
l'"Utilità di avvio di esempio" apparirà come una delle scelte
possibili, con "Programmi di esempio per gli avvii" come
descrizione; la procedura guidata specificata attraverso
com.example.launchers.ui.ExampleLaunchWizard verrà utilizzata per
configurare tutti i dettagli specifici dell'avvio.
Informazione API:
Il valore dell'attributo class deve essere un nome completo di una classe Java che implementa l'interfaccia org.eclipse.debug.core.ILauncherDelegate. Il valore dell'attributo
wizard deve corrispondere al nome completo di una classe Java che
implementa org.eclipse.debug.ui.ILaunchWizard.
Copyright (c) 2000, 2003 IBM Corporation e altri.
Tutti i diritti riservati. Questo programma e il materiale di accompagnamento
sono disponibili secondo i termini della Common Public License v1.0 che sono
distribuiti con il prodotto, e disponibili all'indirizzo
http://www.eclipse.org/legal/cpl-v10.html