與追蹤一起執行

平台提供在執行時期追蹤外掛程式活動但不完整除錯的機制。 它可讓您使用追蹤旗標,這些旗標會使追蹤資訊列印在標準輸出(或「主控台」檢視 畫面)。 這些旗標定義於名稱是 ".options" 的檔案而且使用下列語法:

   <plug-in Id>/debug = true/false  (master switch)
   <plug-in Id>/<tracing flag> = <value>

第一個項目代表追蹤外掛程式的主要切換。 如果在外掛程式類別中呼叫方法 isDebugging,它會傳回 True(如果這個追 蹤變數的值是 True)。 由您定義其他追蹤旗標,使用下列方式可以取得它們的值:

      Platform.getDebugOption(optionName);

大部份平台外掛程式定義追蹤旗標,尤其是平台基核。 對於新的外掛程式開發人員來說,最感興趣的追蹤旗標集是與類別載入相關的旗標,因為這些旗標允許追蹤外掛程式載入問題。

為了支援追蹤而不需要編輯追蹤 .options 檔案,PDE 在啟動對話框中 提供「執行時期追蹤」標籤。所有追蹤設定都儲存在啟動配置中。 這代表您可以使用不同追蹤選項和替代方案建立一些配置。

執行時期工作發射台 - 追蹤

如果您新增追蹤支援至開發下的外掛程式,您的外掛程式將出現在支援追蹤 的外掛程式清單(工作區外掛程式群組),而追蹤內容會出現在內容表中。

範例:  新增追蹤支援到外掛程式

為了允許其他開發人員控制您的外掛程式的追蹤旗標,您必須公開這些選項。 典型的作法是將 .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() 檢查追蹤內容的值。

 
Copyright IBM Corporation and others 2000, 2003