原生应用性能剖析(CLI)
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-native-app-performance
技能介绍
要解决什么问题
在 macOS / iOS 上做 原生应用性能 分析时,Time Profiler 往往意味着打开 Instruments、手工导出再对照符号表。对习惯在终端里排障的工程师来说,这条路径既慢又难自动化:CI 里没法点 UI,远程机器上也不方便挂图形界面。
本技能围绕 纯 CLI 工作流:用 xcrun xctrace 录制 Time Profiler(attach 或 launch 目标二进制)、从 trace 里抽出 time-sample 数据、结合运行时 __TEXT 加载地址(vmmap)做符号化,并汇总应用侧热点栈,全程不必打开 Instruments。
技能如何工作
核心能力对应 SKILL 里列出的脚本与步骤:
scripts/record_time_profiler.sh:按 attach 或--launch直接指向二进制路径录制 tracescripts/extract_time_samples.py:从 trace 导出 time-sample XMLscripts/top_hotspots.py:符号化并按应用帧排序热点
典型顺序是:确认剖析的是 本机构建 还是 /Applications 里的包 → 录制时在 UI 上触发慢路径(菜单开合、刷新等)→ 若栈为空则延长采集、避开空闲段 → 用 xcrun xctrace help record / export 核对参数 → 取 load address → 符号化并看排名。
适用边界与注意点
- ASLR:必须用运行时的
__TEXT加载地址,不能死记编译期地址。 - 换新 build 后要更新
--binary路径,符号必须与 trace 一致。 - CLI 流在栈已通过
atos等方式正确符号化时,可不依赖 Instruments 图形界面;若符号不匹配,热点排名会失真。
适合已熟悉 Xcode 工具链、需要在终端或脚本里完成「录制 → 导出 → 符号化 → 看热点」闭环的 macOS 原生开发场景。
使用场景
- 本地 Debug 包菜单卡顿,需在终端 attach 录制 Time Profiler 并列出应用帧热点
- CI 或 SSH 环境无法开 Instruments,要对指定二进制做 launch 录制并导出 time-sample
- 改版后怀疑某次交互变慢,要在录 trace 时手动触发慢路径再符号化比对栈
- 拿到同事导出的 trace,要用脚本抽样本并结合 vmmap 加载地址做 atos 符号化排名
适合人员
- 维护 macOS 客户端、需在终端复现卡顿并给团队提交热点栈摘要的客户端工程师
- 负责 iOS/macOS 构建流水线、希望在无图形界面节点上跑性能采样脚本的发布工程师
- 性能专项同学,习惯用 vmmap/atos 校对 ASLR 后再解读 Time Profiler 样本
- 接手他人 Instruments 习惯改 CLI 的同学,需要按仓库脚本走完录制到排名的固定步骤