Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Hotspot

也參考

詳情請參閱 sampling profiler instructions 。

  • 打開 Hotspot 。點擊 Record Data :

../../../_images/cpp_profiler_hotspot_welcome.png
  • 在下一個視窗中,指定包含除錯符號的 Godot 執行檔路徑。

  • 可自行決定是否加入命令列參數,以選擇用編輯器或直接執行專案。

  • 如果 --path 命令行參數使用的是絕對路徑,那麼工作目錄的路徑可以隨便設定(填甚麼都可以)。否則(如果 --path 用的是相對路徑),工作目錄就必須設定正確,以確保能根據相對路徑成功找到專案。

  • 如果你有管理員權限,請確保勾選 Elevate Privileges (提升權限)。雖然這對分析 Godot 來說不是絕對必要的,但勾選它能確保捕獲到所有的系統事件。否則,抓取到的資料里可能會缺失一部分事件。現在,你的設定看起來應該差不多是這樣的:

../../../_images/cpp_profiler_hotspot_record.png
  • 點擊 Start Recording,然後在編輯器或專案中執行你要分析的操作。

  • 可以正常退出編輯器或專案,或者點擊 Hotspot 里的 Stop Profiling (停止分析) 按鈕來提前結束分析。如果你對引擎的關閉流程(shutdown procedure)不感興趣,提前結束分析往往能得到更乾淨、更純粹的效能分析報告。

  • 點選 View Results,等待產生視覺化的效能分析結果:

../../../_images/cpp_profiler_hotspot_view_results.png
  • 可利用上方分頁切換不同檢視模式,這些檢視僅是用不同方式展示相同資料。Flame Graph (火焰圖)分頁能一目了然哪些函式最耗時。這些函式便是最應優化的目標,因為優化它們能最有效提升效能。

  • 除了 Summary (摘要) 分頁之外,在所有其他分頁的底部,你還會看到一個由引擎啟動的 CPU 執行緒清單,以及每個執行緒的 CPU 使用率。這能讓你清楚地看到,在特定的時間點上,哪些執行緒可能正在成為效能瓶頸。

../../../_images/cpp_profiler_hotspot_flame_graph.png

備註

如果你不希望把程式啟動階段的過程也包含在效能分析記錄里,你還可以通過點擊 Record Data(記錄資料) ,然後將 Launch Application(啟動應用程式) 的下拉選項設定為 Attach To Process(es)(附加到處理程序) ,來讓 Hotspot 直接連接到一個已經在執行的處理程序上。

這種附加程序的方式和 VerySleepy 的操作流程很像。