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