Esecuzione con funzione di traccia

La piattaforma fornisce un meccanismo per tenere traccia dell'attività del plugin in fase di runtime, senza l'esecuzione di un debug completo. Ciò consente di utilizzare indicatori di traccia che provocheranno la stampa delle informazioni di traccia nell'output standard (o nella vista Console). Questi indicatori sono definiti in file denominati ".options" e presentano la seguente sintassi:

   <plug-in Id>/debug = true/false  (master switch)
   <plug-in Id>/<tracing flag> = <value>

La prima voce rappresenta l'opzione principale per eseguire la traccia del proprio plugin. Se si richiama il metodo isDebugging nella classe del plugin in uso, verrà restituito true se il valore di questa variabile di traccia è true. Altri indicatori di traccia sono definiti dall'utente e i relativi valori possono essere ottenuti utilizzando

   Platform.getDebugOption(optionName);

La maggior parte dei plugin della piattaforma definisce indicatori di traccia, in particolare il nucleo della piattaforma. Per lo sviluppatore di un nuovo plugin, l'insieme di indicatori di traccia più interessante è quella collegata al caricamento delle classi, in quanto consente di tenere traccia dei problemi di caricamento dei plugin.

Utilità di avvo workbench runtime - traccia

Esempio:  aggiunta del supporto di traccia al proprio plugin

Se si aggiunge il supporto di traccia al plugin in fase di sviluppo, i plugin appariranno nell'elenco dei plugin che supportano la traccia.

Per consentire ad altri sviluppatori di controllare gli indicatori di traccia del plugin, è necessario rendere note queste opzioni.  Questa operazione viene generalmente effettuata inserendo un file .options nel plugin.  Nel file sono elencati tutti gli indicatori supportati oltre che i valori predefiniti.

Di seguito verrà definito un file .options modello con alcuni indicatori di traccia per il nuovo plugin dell'utente.

Selezionare il progetto com.example.xyz creato di recente e creare un nuovo file .options. Quando si apre l'editor di testo predefinito, aggiungere quanto segue:

   com.example.xyz/debug = true
   com.example.xyz/debug/flag = true
   com.example.xyz/debug/filter = *

Quando il file viene salvato, selezionare Esegui > Esegui... per aprire la finestra di dialogo di avvio. Ora il plugin dovrebbe apparire nell'elenco. Quando viene selezionato, dovrebbe mostrare i nuovi indicatori e i relativi valori predefiniti.

Utilità di avvio workbench runtime - Esempio di traccia

La creazione del file .options definisce solo gli indicatori di disponibilità, consentendo ad altri sviluppatori di plugin di definire i valori delle proprietà della traccia.  Sarà ancora necessario verificare i valori delle proprietà di traccia nel codice di plugin utilizzando Platform.getDebugOption().