Spuštění s trasováním

Platforma poskytuje mechanizmus pro trasování aktivity modulu plug-in v době provádění bez úplného ladění. Umožňuje použít příznaky trasování, které slouží pro vytištění informací o trasování ve standardním výstupu (nebo pohledu Konzola). Tyto příznaky jsou definovány v souborech s názvem ".options" a mají následující syntaxi:

   <ID modulu plug-in>/debug = true/false  (hlavní přepínač)
   <ID modulu plug-in>/<příznak trasování> = <hodnota>

První položka představuje hlavní přepínač pro trasování modulu plug-in. Jestliže zavoláte metodu isDebugging ve třídě modulu plug-in, vrátí se hodnota True v případě, že je hodnota této proměnné trasování True. Další příznaky trasování definuje uživatel a jejich hodnoty je možné získat pomocí

   Platform.getDebugOption(optionName);

Většina modulů plug-in platformy definuje příznaky trasování, zejména jádro platformy. Pro vývojáře nového modulu plug-in jsou nejzajímavější příznaky trasování, které se vztahují k zavádění tříd, protože umožňují sledování problémů se zaváděním modulů plug-in.

Spouštěč běhové pracovní plochy - Trasování

Příklad:  Přidání podpory trasování do modulu plug-in

Jestliže přidáte podporu trasování do modulu plug-in v průběhu vývoje, zobrazí se moduly plug-in v seznamu modulů plug-in, které podporují trasování.

Chcete-li, aby mohli ostatní vývojáři řídit příznaky trasování modulu plug-in, je třeba tyto volby zveřejnit.  Zpravidla se tak děje umístěním souboru .options do modulu plug-in.   V souboru jsou uvedeny všechny podporované příznaky stejně jako jejich výchozí hodnoty.

Nyní nadefinujete soubor šablony .options s několika příznaky trasování pro nový modul plug-in.

Vyberte projekt com.ukazka.xyz, který jste vytvořili dříve, a vytvořte nový soubor .options. Po otevření výchozího textového editoru přidejte následující položky:

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

Po uložení souboru vyberte položky Spustit > Spustit... a otevřete dialogové okno pro spuštění. Modul plug-in by se měl nyní zobrazit v seznamu. Po výběru by se měly zobrazit nově definované příznaky s jejich výchozími hodnotami.

Spouštěč běhové pracovní plochy - Příklad trasování

Vytvoření souboru .options pouze definuje příznaky dostupnosti a umožňuje ostatním vývojářům definovat hodnoty vlastností trasování.  Je třeba zkontrolovat hodnoty vlastností trasování v kódu modulu plug-in pomocí funkce Platform.getDebugOption().