Uruchamianie ze śledzeniem

Platforma oferuje mechanizm śledzenia aktywności modułu dodatkowego w czasie wykonywania bez konieczności pełnego debugowania. Umożliwia on użycie flag śledzenia, które spowodują drukowanie informacji o śledzeniu na wyjściu standardowym (lub w widoku konsoli). Flagi te są definiowane w plikach o nazwach ".options", a ich składnia jest następująca:

   <Id_modułu_dodatkowego>/debug =
true/false  (przełącznik główny)
   <Id_modułu _dodatkowego>/<flaga_śledzenia> = <wartość>

Pierwszy wpis reprezentuje główny przełącznik śledzenia danego modułu dodatkowego. Wywołanie metody isDebugging w klasie danego modułu dodatkowego spowoduje zwrócenie wartości true, jeśli zmienna śledzenia ma wartość true. Inne flagi śledzenia definiuje się samodzielnie, a ich wartość można uzyskać, używając metody

   Platform.getDebugOption(optionName);

Większość modułów dodatkowych platformy, w szczególności jej jądro, definiuje flagi śledzenia. Dla początkującego programisty modułów dodatkowych najbardziej interesujący zestaw flag śledzenia, to flagi dotyczące ładowania klas, ponieważ umożliwiają one śledzenie problemów podczas ładowania modułu dodatkowego.

Program uruchamiający wykonawcze środowisko robocze - śledzenie

Przykład:  Dodawanie obsługi śledzenia do modułu dodatkowego

Po dodaniu obsługi śledzenia do tworzonego modułu dodatkowego moduł ten zostanie wyświetlony na liście modułów dodatkowych, które obsługują śledzenie.

Aby inni programiści mogli także kontrolować flagi śledzenia modułu dodatkowego, należy ujawnić te opcje.  Robi się to najczęściej, umieszczając plik .options w module dodatkowym.  W tym pliku są wymienione wszystkie obsługiwane flagi, a także ich wartości domyślne.

Poniżej zdefiniowany zostanie szablon pliku .options z kilkoma flagami śledzenia dla nowo utworzonego modułu dodatkowego.

Należy wybrać utworzony wcześniej projekt com.example.xyz i utworzyć nowy plik .options. Gdy zostanie otwarty domyślny edytor tekstu, należy dodać następujące wpisy:

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

Po zapisaniu tego pliku należy wybrać kolejno opcje Wykonaj > Wykonaj, aby otworzyć okno dialogowe uruchamiania. Przykładowy moduł dodatkowy powinien być teraz wyświetlany na liście. Po zaznaczeniu go powinny zostać wyświetlone nowo zdefiniowane flagi i ich wartości domyślne.

Program uruchamiający wykonawcze środowisko robocze - przykład śledzenia

Podczas tworzenia pliku .options definiowane są tylko flagi dostępności, które umożliwiają innym programistom definiowanie wartości właściwości śledzenia.  Sprawdzenie wartości swoich właściwości śledzenia wymaga w dalszym ciągu użycia metody Platform.getDebugOption().