Community程式設計與開發github.com

行動裝置 GPU 效能分析 (Mali 與 Adreno 硬體計數器)

讀取手機 GPU 硬體計數器,找出真實的效能瓶頸(像素、頂點、紋理、頻寬或著色器運算),並提供對應的修正方向。支援 Arm Mali (透過 Arm Performance Studio) 與 Qualcomm Adreno (Snapdragon Profiler / Android GPU Inspector) 平台。

行動裝置 GPU 效能分析 (Mali 與 Adreno 硬體計數器) 是什麼?

這是一個針對行動裝置 GPU 的深度分析技能,其核心價值在於讀取 GPU 內部的硬體計數器,而不是僅從外部測量 FPS、記憶體或溫度。它能明確回答:GPU 真的是瓶頸嗎?如果是,瓶頸是來自像素(Fragment)、頂點/三角形(Geometry/Tiler)、紋理、頻寬(Bandwidth)還是著色器運算(Shader ALU)?每一種瓶頸需要完全不同的修正策略,錯誤的猜測會浪費大量開發時間。 此技能支援兩大行動 GPU 陣營:Arm Mali (包括 Mali 與 Immortalis) 和 Qualcomm Adreno。對 Mali 而言,它能透過 Arm Performance Studio 工具鏈(Streamline 無頭模式、Performance Advisor、Mali Offline Compiler、Frame Advisor、RenderDoc for Arm)進行自動化捕捉與分析;對 Adreno,則可透過 Snapdragon Profiler 或 Android GPU Inspector 取得類似數據。技能附帶了自動化腳本,可透過 adb 捕捉 Mali 計數器,並直接產出診斷報告(報告中的判決會明確指出是 Fragment-bound、Geometry-bound 還是 CPU-bound,以及 Fragments Per Pixel、Shader ALU Per Pixel、紋理壓縮率等關鍵指標)。 使用時機通常是在一般效能分析工具 (`mobile-3d-rendering`) 已經顯示 FPS 不達標,但 Draw Calls 和三角形數量仍在預算內,或者 FPS 沒有隨著減少繪製物件而改善時,才動用這個技能進行深入調查。它也適合用來評估一個高畫質特效(如法線貼圖、4x MSAA、Bloom、更多的動態光源)是否能在目標手機上符合預算。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/P0r0ro/mobile-gpu-profiling-skill/tree/HEAD/mobile-gpu-profiling

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

行動裝置 GPU 效能分析 (Mali 與 Adreno 硬體計數器) 是做什麼的?

mobile-3d-rendering 從外部進行測量:FPS、記憶體、溫度與引擎計數器。 這個技能則直接打開 GPU,讀取它的硬體計數器。它能回答:GPU 真的是極限嗎? 如果是,瓶頸是來自 像素、頂點、紋理、頻寬還是著色器運算?每一種都需要不同的 修正方式,靠猜測只會浪費好幾天。

何時啟用它(升級處理,非第一步驟):

  • mobile-3d-rendering 的初步分析顯示 FPS 未達標,但 Draw Calls 數量在預算內,或者 即使減少了 Draw Calls 和三角形數量,FPS 仍然沒有改善;
  • 需要決定某個高畫質特效(法線貼圖、4x MSAA、Bloom 光暈、更多動態光源)是否能在參考 手機的預算內運作;
  • 找出哪個著色器或材質消耗效能;
  • 出現原因不明的發熱(頻寬消耗是常見原因);
  • 在某個特定 GPU 廠牌上出現 GPU 端的異常行為。

完成分析後,務必使用 mobile-3d-rendering/scripts/device_probe.py 在裝置上重新測量 (FPS、p95、記憶體斜率、溫度)。計數器負責解釋原因,而這個探測腳本負責確認結果。

0. 偵測 GPU 並選擇分析路徑

S=~/.claude/skills/mobile-gpu-profiling/scripts
python3 $S/gpu_profile.py detect          # 廠牌、GPU、驅動程式版本、Android 版本、螢幕尺寸
GPU計數器捕捉著色器成本幀捕捉
Arm Mali / Immortalisgpu_profile.py mali-capture (Streamline, 無頭模式)malioc_batch.py (Mali Offline Compiler)Frame Advisor, RenderDoc for Arm GPUs
Qualcomm AdrenoSnapdragon Profiler Realtime/Trace (GUI),或在支援的 Android 11+ 裝置上使用 AGIAdreno offline compiler (若有) 或 SDP 著色器統計Snapdragon Profiler Snapshot, AGI 幀剖析器
其他 (PowerVR, Xclipse)廠商工具 / AGI; gpu_profile.py gpu-busy—RenderDoc / AGI

各工具的安裝說明:references/arm-performance-studio.md, references/adreno.md。 應用程式必須是 可偵錯版本(Godot:debug export;Unity:Development Build; android:debuggable="true")。

1. Mali:捕捉並讀取計數器

python3 $S/gpu_profile.py mali-capture -p <package> -s 30 -o gpu-profile-<name>
#   首次執行會根據 Arm 針對該 GPU 的範本建立計數器設定檔(快取在 ~/.cache/mobile-gpu-profiling)
#   腳本會啟動應用程式;請遊玩你想測量的場景(最壞情況:人群、戰鬥、夜晚)
python3 $S/gpu_profile.py mali-analyze gpu-profile-<name>/capture.apc --fps 60   # 稍後重新讀取

它會寫出 report.md 和 metrics.json。先閱讀報告頂部的判決,再查看數據:

計量指標在中階手機上的健康數值如果不正常
gpu_util< 75–80% 在目標 FPS 時(保留散熱餘裕)> 85%:GPU 瓶頸,請閱讀以下行。< 60% 且 FPS 低:CPU 瓶頸,請對 CPU 進行分析
fragment_queue_util vs non_fragment_queue_util / tiler_util—哪個接近 100% 就是極限:fragment = 每像素成本;non-fragment/tiler = 頂點、三角形、陰影投射物
fragments_per_screen_pixel< 2.0 (所有渲染 Pass)過度繪製、陰影貼圖、額外的渲染 Pass(請參閱 render_passes_per_frame)
alu_instr_per_fragment< 20–30 (Bifrost 架構)複雜的片段著色器 → 請參閱 §2
tex_compressed_share / tex_mipmapped_share場景紋理應為高未壓縮/無 Mipmap 的紋理浪費頻寬和快取(陰影貼圖和渲染目標永遠不會被壓縮,所以請檢查哪些紋理佔主導地位)
late_zs_test_share< 10%discard/alpha test,或著色器深度寫入,停用 Early-Z
early_zs_kill_rate, fpk_occluding_share高是好的由前到後排序不透明物件;避免在大型表面使用 discard
bandwidth_mb_per_frame< 約 30–40 MB (60 fps, 2018–2020 年手機)渲染目標、未壓縮紋理、MSAA 解析 → 發熱
facing_culled_share約 40–50%(封閉網格)雙面材質使頂點工作量加倍
fp16_varying_share高mediump varyings 可將插值成本減半

完整的計數器對應修正參考,包含公式,位於 references/mali-counters.md。

幀標記:Performance Advisor 的逐幀 HTML 報告需要來自 Arm Layer 的幀邊界。 Arm 支援 Android 11+。在 Android 10(已在 Galaxy Note 9 上測試)上,計數器可以運作,但 Layer 的幀從未到達 gatord,因此腳本會改為使用捕捉期間從 SurfaceFlinger 測量到的 FPS, 乘以每秒計數器來推算。

2. 找出耗費效能的著色器(任何引擎,Mali 成本模型)

# Godot (Compatibility/GLES3):透過桌面的 Mesa 傾印遊戲實際編譯的 GLSL ES
HEADLESS=1 $S/godot_dump_shaders.sh <godot_project> dump/ 20 [res://test_scene.tscn]
python3 $S/malioc_batch.py --core Mali-G72 dump/ --label-src <godot_project>/shaders --top 15
  • 排名列表會顯示每個像素(或每個頂點)的週期數,以及哪個管線階段是瓶頸(A 算術、 LS 載入/儲存、V 變數、T 紋理)。標籤會標明 你的 著色器檔案;"engine" 表示內建模 材。
  • 旗標:occ50 表示使用了超過 32 個工作暫存器,因此只有一半的執行緒在運行(延遲隱藏 效果較差);SPILL 表示堆疊溢出;lateZS 表示使用了 discard;fp16:0% 表示沒有 使用 16 位元運算。
  • 一個著色器的成本 ≈ 週期數 × 它所覆蓋的像素。一個覆蓋地面和建築物的 38 週期著色器, 遠比一個只用在小型招牌上的 60 週期著色器重要。
  • Unity、three.js 和 Bevy 的著色器提取方法:references/shader-cost.md。

傾印腳本會針對一份使用者資料的複製品執行遊戲,因此不會影響存檔和設定,同時 Godot 的 著色器快取也不會隱藏編譯過程。請在執行期間造訪你關心的區域(或傳入一個測試場景)。 Godot 會惰性編譯著色器變體。

3. Adreno (Qualcomm)

使用 Snapdragon Profiler:Realtime 模式用於即時指標,Trace 模式用於時間軸,Snapshot 模式 用於單一幀的逐個 Draw Call 統計資料。從它的指標中讀取相同的問題:% Shaders Busy、 % Time Shading Fragments vs Vertices、Avg Bytes / Fragment、% Texture Fetch Stall、 % Texture L1 Miss、ALU / Fragment、% Prims Trivially Rejected、Read/Write Total。 指標對應修正的表格在 references/adreno.md 中。

在支援 AGI 的 Android 11+ 裝置上,Android GPU Inspector 提供廠商中立的計數器以及一個 幀剖析器。如果想要一個不需要工具的快速使用率讀數,可以執行 gpu_profile.py gpu-busy -s 30, 它會讀取核心的 busy 節點(如果版本允許)。

4. 從計數器到修改(然後驗證)

  1. 修正報告指出的最大限制因素。一次只做一個修改。

  2. 典型的對應關係:

    極限修正方法
    Fragment-bound使用更少/更小的陰影貼圖和更短的陰影距離、減少透明物體的 Overdraw、在大型表面使用更便宜的著色器(將運算移至頂點著色器、在低/中畫質設定下移除逐像素噪點/霧氣/高光、使用 mediump)、使用壓縮且具有 Mipmap 的紋理、僅在確認安全的地方降低內部解析度(Mali-G72 在渲染縮放時曾發生記憶體洩漏)
    Geometry/Tiler-bound設定 LOD 和可見範圍、減少陰影投射物、啟用背面剔除、對人群模型使用更簡單的蒙皮
    Bandwidth/Heat使用壓縮紋理、減少渲染目標/Pass、使用 MSAA 取代後處理反鋸齒、避免全螢幕後處理特效
    CPU-bound (GPU < 60% 忙碌)減少 Draw Calls、改善腳本、動畫、物理運算 (performance-optimization)
  3. 重新捕捉同一個場景,並比較修改前後的 metrics.json(GPU 每幀毫秒數、限制因素的佔比)。

  4. 使用 device_probe.py 在裝置上確認至少 60 秒(FPS、p95、記憶體斜率、溫度)。一個讓手機 發熱或導致記憶體洩漏的計數器勝利不是真正的勝利。

  5. 將發現記錄在專案筆記中(什麼是瓶頸、如何修正、修改前後的數值)。

實戰經驗法則(來自真實捕捉經驗)

  • 從 GPU 的範本產生計數器設定,並且預設只保留 GPU 計數器。CPU PMU 計數器曾經導致 Samsung Android 10 核心上的捕捉子程序在一開始就結束。
  • Wi-Fi adb 可以運作,但裝置 ID 是 ip:port。請在每個命令中都傳入它(腳本已經這樣做)。
  • 崩潰的捕捉可能會在應用程式的沙盒中留下仍在執行的 gatord 代理程式。它們會阻擋下一次 捕捉的 socket(「Address already in use」)並使捕捉提前結束。腳本會透過 PID 殺死它們 (run-as <pkg> pkill 無效)。
  • 在捕捉前立即強制停止應用程式,可能會導致捕捉在一秒後就結束。腳本會等待系統穩定。
  • Streamline-cli -generate-config 的 -template <name> 參數必須放在目標之前,儘管其 -help 說明文字指示不同。
  • Godot 會在 user://shader_cache 中保留 GLES 著色器快取,因此第二次在桌面執行時將不會 編譯任何內容。請使用一個全新的 XDG_DATA_HOME(傾印腳本已經這樣做)。
  • 在桌面上執行真實遊戲以進行審計時,會寫入遊戲的自動存檔。請隔離使用者資料目錄。

參考資料

檔案何時閱讀
references/arm-performance-studio.md安裝/使用 Streamline、Performance Advisor、Frame Advisor、RenderDoc for Arm、malioc;無頭管線細節
references/mali-counters.md每個 Mali 指標的意義、公式、閥值、Bifrost vs Valhall vs 第五代架構
references/adreno.mdSnapdragon Profiler / AGI 設定以及 Adreno 的指標對應修正表格
references/shader-cost.md從 Godot/Unity/three.js/Bevy 中取得已編譯著色器,並讀取 malioc 輸出

相關技能