Futtatás nyomkövetéssel

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.

Futtatási munkaterület indító - nyomkövetés

Példa:  Nyomkövetési támogatás hozzáadása a bedolgozóhoz

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.

Futtatási munkaterület indító - nyomkövetési példa

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.