外观
快速入门：5 分钟开启 iOS 无侵入性能测试
Perfowl 是一款专为 iOS 设计的原生、无侵入性能测试工具。无需修改 App 源码、无需重签名、无需越狱，即可直接对 App Store 线上发布包或日常测试包进行工业级精度的性能评测。
跟随本文档，只需 3 步即可完成首次性能测试。
前置环境准备
| 准备项 | 基础要求 | 说明 |
|---|---|---|
| Mac 电脑 | macOS 13.0 (Ventura) 及以上 | 支持 Intel x86_64 与 Apple Silicon (M1/M2/M3/M4) |
| 被测 iPhone | iOS 15.0 ~ iOS 18.x 及以上 | 手机需开启「开发者模式」（iOS 16+）并完成设备信任 |
| 连接数据线 | 原装或 MFi 认证 Lighting / Type-C 数据线 | 首次连接需使用 USB，后续支持 Wi-Fi 无线连接 |
| Xcode / Command Line Tools | 可选（非必需） | Perfowl 自带原生连接引擎，无需安装体积庞大的 Xcode |
步骤一：连接设备并信任电脑
- 使用 USB 数据线将 iPhone 连接至 Mac 电脑。
- 解锁 iPhone 屏幕，在弹出的提示框中点击 「信任此电脑」 并输入锁屏密码。
- 开启开发者模式 (iOS 16+)：
- 在手机上打开「设置」→「隐私与安全性」→ 滑动到底部找到「开发者模式」；
- 打开开关，根据系统提示重启手机，并在重启后再次确认启用。
步骤二：选择被测设备与目标应用
- 打开 Perfowl 客户端，在顶部导航栏的 「设备选择」 下拉列表中选择刚刚连接的 iPhone。
- 系统会自动识别连接路由（USB 或 Wi-Fi），并进行无感初始化。
- 当设备名称右侧显示绿色圆点时，代表设备准备就绪。
- 点击 「选择应用」 下拉列表：
- Perfowl 会自动枚举手机上已安装的全部第三方用户应用（User App）；
- 在搜索框中输入 App 名称或拼音，选中你要测试的目标应用。
- 选择测试指标方案：
- 2026-10-29内部候选默认勾选全部已实现指标，包含 Startup 和 ScreenShot（截图时间轴）；系统条件尚未验证的项目显示待验证，不保证每项有数值。
- 取消项会记住，并从下一次测试生效；当前测试继续使用开始时的计划。取消截图也关闭新截图请求和预览，历史图片保留。
- 只采截图也可开始；全部取消会提示至少选择一项。启动选择不在连接或准备时操作应用，开始前仍须核对当前启动模式。
- FTime不再以启动勾选决定需求；新增独立CoreProfile自动录制仍等待成本与真机门，缺口不会用0代替。实现边界与测试。
步骤三：开始测试与实时观察
- 点击界面中央醒目的绿色 「开始测试 (Start)」 按钮：
- Perfowl 会自动在手机上拉起目标应用，并立即建立高频性能采集通道；
- 界面进入实时监控视口，多维指标曲线随时间轴平滑滚动推进。
- 在手机上执行业务测试：
- 正常操作你的 App（如滑动信息流、进入详情页、播放视频或进行游戏对局）；
- 如需记录特定操作时刻，可在工作台右下角的 「标注 (Note)」 框中输入文字（如“点击购买”）并按回车，系统会在当前时间轴打下标记旗帜。
步骤四：停止测试与复盘导出
- 完成测试操作后，点击顶部的红色 「停止测试 (Stop)」 按钮：
- 客户端立即停止采样并冻结时间轴，并在数秒内完成数据落盘与校验。
- 历史会话审查 (Review)：
- 界面无缝切换为全量回放视图，可自由拖动游标、框选时间区间，审查卡顿时刻的 CPU、内存、网络及对应的屏幕截图。
- 导出测试报告：
- 点击右上角 「导出」 按钮，支持导出标准结构化 CSV 表格（供 Excel 分析）或 JSONL 资产包（供 CI 看板归档）。
下一步深入阅读
2026-10-29 · 采集意图说明更新
默认全量减明确取消，17组映射66数值ID与截图附件；属于内部候选软件合同，不新增正式验收。来源为独立帧与默认全采方案。
2026-10-30 · 开始后立即结束的排查
内部235曾出现启动源等待5秒就绪后整场失败、普通样本0但截图已保存的情况；这不是单纯图表刷新问题，也不能只凭TimeoutError认定手机断连。软件修复候选仅将本地启动源就绪期限耗尽作为局部降级：启动端点缺失保持空值，健康普通源继续；源自身异常、合同错误与取消仍分别处理，不无条件忽略超时。新版本真机行为仍待Owner复测，见本批定位、修复与证据。