Instruments性能分析

技能简介

该技能用于对原生macOS或iOS应用进行性能剖析与堆栈分析，基于Xcode Instruments工具链，支持xctrace命令行与图形界面两种工作模式。

能做什么

• 通过CLI录制Time Profiler追踪文件
• 启动或附加到目标进程进行采样
• 导出原始堆栈数据供后续脚本处理
• 识别常见陷阱（如错误二进制、空采样）
• iOS真机设备的性能数据采集

使用说明

安装前提：需安装Xcode及命令行工具，确保xcrun可用。

步骤1：列出可用模板

xcrun xctrace list templates

步骤2：录制性能追踪（启动模式）

xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --launch -- /path/To/App.app

步骤3：录制性能追踪（附加模式）

先启动应用获取PID，然后执行：

xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --attach <pid>

步骤4：打开追踪文件

open -a Instruments /tmp/App.trace

关键提示：为避免LaunchServices解析到错误应用，建议直接使用二进制路径：/path/App.app/Contents/MacOS/App

输入与输出

见下方输入与输出表格。

风险提示

• 可能因LaunchServices解析而采集到错误的应用实例
• 应用快速退出会导致采样为空
• 首次使用需在系统设置中授予开发者工具权限
• 导出的XML堆栈数据体积较大，不宜直接终端输出

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/steipete/instruments-profiling/SKILL.md
来源类型：GitHub仓库