您可以使用 Probekit 編輯器的視覺化介面來建立新探測的程式碼。
若要使用 Probekit 編輯器來建立探測,請執行下列步驟:
- 用滑鼠右鍵按一下要包含探測的專案,再從蹦現功能表選取新建 > 其他。
- 在選取精靈頁面中,展開側寫和記載,並選取 Probekit 程式檔。
- 按下一步。
- 在建立新探測檔精靈的檔案名稱欄位中,輸入新探測程式檔的名稱。探測程式檔的副檔名必須是 .probe。
- 在來源資料夾中,選取要包含新探測程式檔的專案來源資料夾。
您可以在編輯框中輸入資料夾名稱,或是在樹狀結構窗格中選取資料夾。
附註:探測程式檔必須出現在專案來源資料夾的最上層;探測程式檔不能在子資料夾中。
- 選取您要新增至探測的內容類型。若您選取方法探測或 Callsite 探測,則也必須選取片段類型。
- 按下一步。
- 使用新增按鈕,依需要來新增多個資料探測物件。適用於所建立之探測類型的資料探測說明,會顯示在頁面底部。
附註:如果返回去變更所要建立之探測的類型,或是所要插入的片段類型,精靈可能會提示您捨棄不再套用的資料探測物件。
- 按一下完成。 新的 .probe 檔會出現在專案來源資料夾中,而且依預設會自動在 Probekit 編輯器中開啟。
- 選取一般標籤。
- 在 ID 欄位中,輸入探測的唯一 id 字串,並可選擇性地在版本欄位中輸入版本號碼。在「Probekit 登錄」中,將會使用該 id 字串來識別唯一的探測。如果需要詳細資訊,請參閱 Probekit 物件。
- 選取探測標籤,再按一下新增探測按鈕。
新的探測物件會出現在樹狀結構窗格中。
- 在編輯器樹狀結構中用滑鼠右鍵按一下探測物件,並從蹦現功能表選取。
新的片段物件會出現在樹狀結構中,成為探測物件的子項,而片段的內容欄位會顯示在編輯窗格中。
- 在編輯窗格中選取片段類型,然後輸入探測片段的 Java 程式碼。如果需要詳細資訊,請參閱片段探測物件。
- 繼續定義您的探測:在樹狀結構中選取物件,然後使用蹦現功能表來新增子物件,然後在編輯窗格中輸入新物件的值。如需探測物件及其內容的詳細資訊,請參閱 Probekit 元素參照。
蹦現功能表只會針對在樹狀結構中選定的物件,列出有效的子物件。若是有效但無法再新增的物件,就會停用其功能表項目。
附註:當您在「匯入探測物件」的
匯入指引內容欄位中輸入值時,僅限輸入您要匯入之套件或類別的名稱。請勿輸入 "import" 關鍵字,或是在字尾加上分號 (;)。
- 當您完成定義探測時,請按一下。
附註:儲存好 .probe 檔之後,「Probekit 編輯器」會檢查檔案中所有 Java 元素的語法,並且向使用者報告任何 javac 問題。若物件含有錯誤或警告,其在樹狀結構中的圖示就會變更成錯誤或警告圖示。
Javac 問題會顯示在編輯器之「探測」標籤底部的表格中。
在此表格中的項目上連按兩下,就會變更「探測」樹狀結構右邊窗格的焦點,並且將焦點放在包含 javac 錯誤或警告的小組件上。
若為多行的 Java 小組件,例如:顯示在附屬畫面中的「Java 程式碼」小組件,將會選取該小組件的第一行,而使用者要捲動至有問題的那一行。「語法問題」表格不支援過濾功能。