instruments-profiling
由 steipete 提供
iOS & macOS Development简介
Use when profiling native macOS or iOS apps.
描述
该技能的功能
Covers performance profiling for native macOS and iOS apps using xctrace CLI and the Instruments UI. Addresses correct binary selection, CLI arguments, stack exports, and common gotchas like LaunchServices resolving the wrong app bundle.
Instruments and xctrace have non-obvious argument ordering and bundle-resolution gotchas that cause silent profiling errors; this skill documents the fixes directly.
何时使用
- Profiling slow app startup on macOS
- Capturing CPU samples from a running iOS app by PID
- Exporting time-profile stacks to XML for offline analysis
- Identifying hot frames in a native app's call tree
- Attaching a profiler to a live process without restarting it
示例工作流
User asks: how do I profile my macOS app's startup with xctrace?
- 1
Run
xcrun xctrace list templatesto confirm Time Profiler is available - 2
Locate the direct binary path to avoid LaunchServices resolving an installed bundle instead of the local build
- 3
Run
xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --launch -- /path/App.app/Contents/MacOS/App - 4
Verify the traced process path matches the intended build using
ps -p <pid> -o comm= -o command= - 5
Open the trace with
open -a Instruments /tmp/App.traceand review the call tree with Invert Call Tree and Hide System Libraries
A .trace file opened in Instruments showing CPU samples and hot frames covering the app's startup path
前置要求
- Xcode installed (provides xctrace CLI and Instruments)
- Developer Tools permission granted in System Settings → Privacy & Security → Developer Tools
安装
clawhub install steipete/instruments-profiling运行 CLI 命令,或把这段提示词粘贴到 Claude Code、Cursor、Codex 或你在用的任意编程智能体里。