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.
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.
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().