平台提供在執行時期追蹤外掛程式活動但不完整除錯的機制。 它可讓您使用追蹤旗號,這些旗號會使追蹤資訊列印在標準輸出(或「主控台」檢視 畫面)。 這些旗號定義於名稱是 ".options" 的檔案而且使用下列語法:
<plug-in Id>/debug = true/false (master switch)
<plug-in Id>/<tracing flag> = <value>
第一個項目代表追蹤外掛程式的主要切換。 如果在外掛程式類別中呼叫方法 isDebugging,它會傳回 True(如果這個追 蹤變數的值是 True)。 由您定義其他追蹤旗號,使用下列方式可以取得它們的值。
Platform.getDebugOption(optionName)"
大部份平台外掛程式定義追蹤旗號,尤其是平台基核。 對於新的外掛程式開發人員來說,最感興趣的追蹤旗號集是與類別載入相關的旗號, 因為這些旗號允許追蹤外掛程式載入問題。
為了支援追蹤而不需要編輯追蹤 .options 檔案,PDE 提供"執行 時期追蹤"喜好設定頁面,該頁面可讓您設定追蹤旗號以及與載入相關的名稱過 濾條件。
執行時期類別載入追蹤則以特別方式處理,因為對於大部份外掛程式開 發人員來說它是有用的一般追蹤。 PDE 也提供通用對話框以控制其他追蹤旗號。 「進階追蹤」喜好設定頁面顯 示支援追蹤的外掛程式。 選取一個外掛程式時,它支援的通用選項顯示在 內容表。 您可以針對工作區和外部外掛程式變更這些追蹤選項的值。
如果在開發時新增追蹤支援到外掛程式,那麼這些追蹤值會顯示在 這個頁面。
PDE 提供"執行時期工作台"發射台,名稱是"含有追蹤的執行時 期工作台"。 這個發射台會依據來自「喜好設定」的追蹤設定建立合併的 .options 檔案,並將它傳送到執行時期平台實例。 所有追蹤輸出會顯示在「主控台」檢視畫面。
為了允許其他開發人員控制您的外掛程式的追蹤旗號,您必須公開這些選項。 典型的作法是將 .options 檔案放到外掛程式中。 此檔案列示所有支援的旗號以及它們的預設值。 PDE 會立即偵測這個檔案並將它併入進階追蹤喜好設定頁面上的"工作區外掛程 式"清單。
我們現在要使用新外掛程式的幾個追蹤旗號定義範本 .options 檔案。
選取先前建立的 com.example.xyz 專案並建立新檔案 .options 。 預設的文字編輯器開啟時,新增下列項目:
com.example.xyz/debug = true
com.example.xyz/debug/flag = true
com.example.xyz/debug/filter = *
儲存這個檔案之後,開啟喜好設定->進階追蹤頁面。 現在外掛程式應顯示在"工作區外掛程式"下面。 選取之後,它應該顯示含有預設值的新定義的旗號。
建立 .options 檔案只定義可用性旗號,允許其他外掛程式開發人員定義 追蹤內容的值。 您仍需要在外掛程式程式碼中使用 Platform.getDebugOption() 檢查追蹤內容的值。