Mali Offline Compiler 实战:移动 GPU Shader 离线预算与 CI 审计
摘要:RenderDoc 能观察某一帧实际执行的 Shader,但无法在每次提交时覆盖所有变体。离线编译器可以在不运行完整场景的情况下输出指令、寄存器和吞吐估计。本文设计从 Shader 清单、目标 GPU、编译结果解析到增量门禁的流水线,并说明离线估计不能替代真机测量。
一、离线编译适合发现什么
- 某次提交导致算术、纹理或分支成本显著增长;
- 寄存器压力上升,可能降低并行度;
- 特定 GPU 架构编译失败或产生警告;
- 大量变体中少数异常项;
- 源码相同但宏、精度或目标不同造成的产物变化。
它不能直接给出整帧 GPU 时间,因为真实耗时还受 DrawCall 数、像素覆盖、缓存、带宽、Overdraw 和运行时状态影响。
二、编译任务身份
1{ 2 "shader_id": "shader_demo_0031", 3 "stage": "fragment", 4 "source_hash": "...", 5 "defines_hash": "...", 6 "target_gpu_family": "mali_demo", 7 "compiler_version": "tool_x", 8 "entry": "main" 9} 10
源码哈希之外必须包含宏、入口、Stage、目标 GPU 和编译器版本。
三、标准化输出
1{ 2 "status": "SUCCESS", 3 "work_registers": 32, 4 "arithmetic_cycles": 18.4, 5 "texture_cycles": 12.0, 6 "load_store_cycles": 4.2, 7 "warnings": ["precision_conversion"], 8 "parser_version": "1.3" 9} 10
不同工具版本的字段和估计模型可能改变,因此跨版本比较需要新 epoch 或重新编译历史基线。
四、批量编译隔离
1def compile_job(job, runner, parser): 2 result = runner.run( 3 source=job.source, 4 stage=job.stage, 5 target=job.target, 6 timeout_s=60, 7 ) 8 if result.timed_out: 9 return {"status": "TIMEOUT"} 10 return parser.parse(result.stdout, result.stderr) 11
运行器使用允许列表,不接受任意可执行文件和命令参数。每个任务独立目录,结束后只保留标准化结果和必要调试日志。
五、门禁策略
1shader_offline_gate: 2 compile_failure: block 3 new_warning: watch 4 max_register_growth: 8 5 max_arithmetic_growth_ratio: 0.15 6 max_texture_growth_ratio: 0.15 7
只有绝对变化和相对变化同时超过阈值时阻塞,减少小数值的比例误报。
六、归因到变体与责任模块
报告不只列 TopN Shader 名称,还应输出变体宏差异、目标平台、资源/材质族和提交责任模块。真实名称在公开文章中用别名。
七、精度问题
移动 Shader 中 half/mediump 与 full/highp 的选择可能影响性能和画质。离线工具的警告只能作为候选;修改精度后必须验证数值范围、画面误差和目标设备兼容性。
八、与 RenderDoc 和真机 Trace 配合
1离线 CI 发现异常变体 → 确认实际场景是否使用 → RenderDoc 检查事件与覆盖 2→ 真机 GPU/帧时间验证 → 优化后重新跑离线与运行时对照 3
九、存储和脱敏
不上传真实 Shader 源码、宏、资源名和编译转储。长期保存标准指标、哈希和编译器版本;大量临时预处理源码按任务清理。
结语
Shader 离线审计的价值,是把运行时才暴露的问题前移到提交阶段。它适合做大规模筛选,而 RenderDoc 和真机数据负责最终证实;只有两者闭环,预算才既高效又可信。
参考文档
《Mali Offline Compiler 实战:移动 GPU Shader 离线预算与 CI 审计》 是转载文章,点击查看原文。
