用途:诊断原生层面的性能问题,包括 CPU 热点、UI 卡顿和内存泄漏。
主要能力:提供五个工具。native-profiler-start 在已启动设备上开始剖析(iOS 用 xctrace 录制 CPU、卡顿与泄漏;Android 用 Perfetto);native-profiler-stop 停止并导出带时间戳的 XML 追踪数据;native-profiler-analyze 解析数据返回结构化瓶颈列表;profiler-stack-query 用于下钻(hang_stacks、function_callers、thread_breakdown、leak_stacks 等);profiler-load 列出并重新加载历史会话。
平台支持:iOS 依赖 Xcode 命令行工具(可用 xcrun xctrace version 校验),需模拟器或已连接设备,但物理 iPhone 不支持,须用模拟器。Android 需目标应用可调试,或 manifest 中包含 <profileable android:shell="true"/>,以捕获 perf_sample 调用栈;其内存压力信号仅为提示,需人工确认,并非已确认泄漏。
使用方式:按流程操作。先确保目标应用已运行(未运行则用 launch-app 启动),调用 native-profiler-start 传入 device_id 开始录制,让用户操作应用,再调用 native-profiler-stop 导出,然后 native-profiler-analyze 生成报告,最后用 profiler-stack-query 下钻。结果按严重度分为 RED(CPU 函数占用超 15%、所有 UI 卡顿、有归因的内存泄漏)与 YELLOW(CPU 占用 3–15%、未归因泄漏)。
适用场景:需要定位原生卡顿、CPU 热点或泄漏根因的性能排查。
限制:模拟器性能反映宿主 Mac,准确计时与内存行为应使用真机剖析;xctrace 会引入额外开销,JSLexer、JSONEmitter 或 Hermes 运行时的条目应视为剖析开销;单次运行波动属正常,只有跨两次以上或超过 15% 的变化才可视为有效信号。iOS 泄漏若归因缺失(<Call stack limit reached>),可重跑 native-profiler-start 并设 malloc_stack_logging: true,但会重启应用并增加开销。应用若拉取实时数据,不同响应会独立于代码改变渲染负载,需注意数据依赖页面的波动。