Agent Skills
返回列表
💻

Instruments 原生应用性能剖析

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-instruments-profiling。

技能介绍

你真正卡在哪

给 macOS 或 iOS 原生程序做性能排查时,瓶颈往往在「采的是不是对的进程」以及「栈里能不能看到业务帧」。LaunchServices 很容易把 --launch 指到 /Applications 里的同名 .app,本地调试构建的 trace 却是一场空。另一类常见情况是应用秒退、录制窗口太短,导出的 trace 几乎没有有效 sample。

技能覆盖的核心能力

本技能以 Time Profiler 与 xctrace 为主线,区分两种入口:

  • 启动录制:xcrun xctrace record --template 'Time Profiler' --launch --,目标最好是 App.app/Contents/MacOS/App 这类确定路径,而不是含糊的 bundle 名。
  • 附着已有进程:先自行拉起应用,用 ps 核对 comm/command,再 --attach <PID>。

录制结束后可用 open -a Instruments 打开 .trace;需要自动化对比时,用 xcrun xctrace export 配合 --toc 或 XPath 拉出 time-profile 表,再在 Python/Rust 里聚合调用栈。技能里还整理了 Instruments 侧的操作习惯:Hide System Libraries、Invert Call Tree、按线程拆分,以及 iOS 上 --device、符号表等前置条件。

适用边界与注意点

  • 面向 原生 应用与 CLI 工具,不是 Web 或纯 SwiftUI 预览的性能替身方案。
  • xcrun xctrace --help 无效,应使用 xcrun xctrace help record。
  • 首次在终端跑 xctrace 可能触发 开发者工具 隐私授权。
  • 完整 time-profile XML 体积很大,应在脚本里过滤聚合,避免直接往终端灌。

核对清单:trace 对应进程的路径是否为目标构建、栈上是否出现预期帧、录制是否覆盖启动或刷新等慢路径。

使用场景

  • 本地 Debug 构建启动偏慢,需要用 Time Profiler 录 60 秒并确认 trace 来自正确二进制路径。
  • 已运行的 macOS 客户端出现卡顿,需附着指定 PID 录制并在 Call Tree 里隐藏系统库找热点帧。
  • 优化一轮后想把两次采样的调用栈导出为 XML,在脚本里做栈聚合与前后对比。
  • 真机 iOS 应用要在指定 device 上 attach 录制,并检查符号是否足以解析业务栈帧。

适合人员

  • 维护 macOS 客户端的工程师,需要在每次发版前用 Instruments 锁定启动耗时 regression。
  • 负责 iOS 性能问题的客户端开发,要在真机上复现卡顿并用 xctrace attach 留证。
  • 做本地构建与已安装 App 并存的开发者,曾被 LaunchServices 录错进程、需要可重复的 CLI 流程。
  • 写性能自动化或基准脚本的工程师,要把 `xctrace export` 的栈数据接到自有分析流水线。