A platform egy mechanizmust biztosít a bedolgozó tevékenységének nyomkövetésére futás közben teljes hibakeresés nélkül. Ez lehetővé teszi nyomkövetési kapcsolók megadását, amelyek a nyomkövetési információkat a szabványos kimenetre küldik (vagy a konzol nézetre). Ezek a kapcsolók a ".options" fájlokban vannak megadva, és a szintaxisuk a következő:
<bedolgozó azonosító>/debug = true/false (főkapcsoló) <bedolgozó aonosító>/<nyomkövetési kapcsoló> = <érték>
Az első bejegyzés a bedolgozó nyomkövetésének főkapcsolója. Ha meghívja a bedolgozó osztály isDebugging metódusát, az igaz értéket ad vissza, ha ennek a nyomkövetési változónak az értéke igaz. A többi nyomkövetési kapcsolót a felhasználó adja meg, és értékeik a következőképp kérdezhetők le:
Platform.getDebugOption(optionName);
A platform legtöbb bedolgozója nyomkövetési kapcsolókat ad meg, különösen a platformmag. Egy új bedolgozófejlesztő számára a legérdekesebbek az osztálybetöltésre vonatkozó nyomkövetési kapcsolók, mert segítségükkel lehetséges a bedolgozóbetöltési problémák nyomkövetése.
Ha nyomkövetési támogatást vesz fel a fejlesztett bedolgozóhoz, a bedolgozók a nyomkövetést támogató bedolgozók listájában jelennek meg.
Ahhoz, hogy más fejlesztők is beállíthassák a bedolgozó nyomkövetési kapcsolóit, ismertté kell tennie ezeket a beállításokat. Ezt általában a bedolgozóban egy .options fájl elhelyezésével oldják meg. A fájl felsorolja az összes támogatott kapcsolót és az alapértelmezett értékeiket.
Néhány nyomkövetési kapcsolót tartalmazó sablon .options fájlt fogunk megadni az új bedolgozónkhoz.
Válassza ki a korábban létrehozott com.example.xyz projektet, és hozzon létre egy új .options fájlt. Amikor megjelenik az alapértelmezett szövegszerkesztő, vegye fel a következő bejegyzéseket:
com.example.xyz/debug = true com.example.xyz/debug/flag = true com.example.xyz/debug/filter = *
Ha elmentette ezt a fájlt, válassza ki a Futtatás > Futtatás... menüpontot az indítási párbeszédpanel megnyitásához. Az új bedolgozónak meg kell jelennie a listában. Kiválasztáskor az újonnan megadott kapcsolókat kell mutatnia az alapértelmezett értékeikkel.
A .options fájl létrehozása csak a rendelkezésre álló kapcsolókat adja meg, hogy más bedolgozófejlesztők megadhassák a nyomkövetési tulajdonságok értékeit. A Platform.getDebugOption() segítségével ellenőriznie kell a nyomkövetési tulajdonságok értékeit a bedolgozó kódjában.