1# SmartPerf性能工具使用指导 2 3## 概述 4 5为支撑OpenHarmony性能测试，我们向用户提供了符合功能需求并且可靠、易用的性能测试工具。支持开发者针对应用进行相应的性能数据采集以及指标计算功能。 6 7## 简介 8 9SmartPerf端是一款基于OpenHarmony系统开发的性能功耗测试工具，操作简单易用，可提供包括性能、功耗的关键KPI指标，给出具体指标的测试值，包括采集设备的FPS、CPU、GPU、Ftrace等指标数据； 10 11目前SmartPerf工具提供了两种使用方式，分别为hap应用可视化操作方式(SmartPerf-Device)和shell命令行方式(SmartPerf-Daemon),其中SmartPerf-Device支持可视化操作、悬浮窗控制暂停，悬浮窗实时展示数据，SmartPerf-Daemon主要适用于无屏设备、性能较差的设备，对3568等设备同样支持。 12 13## 实现原理 14 15SmartPerf工具主要包括SmartPerf-Device、SmartPerf-Daemon两个部分，其中Device采集的FPS、RAM、Trace等指标需要通过发送消息给Daemon端去采集数据，然后接收Daemon回传的数据展示，同时Daemon端也提供了shell命令的方式单独执行采集，工具的主要功能组成如下图： 16 17 18 19## 约束与限制 20 211.SmartPerf-Device、SmartPerf-Daemon在3.2系统版本后开始预制使用。 22 232.其中SmartPerf-Device的使用必须是具备屏幕的设备。 24 25## 环境准备 26 27SmartPerf-Daemon执行需要PC连接OpenHarmony设备，如RK3568开发板等。 28 29## 执行性能测试 30 31**SmartPerf-Device应用可视化使用示例** 32 33以下SmartPerf-Device应用内截图以RK3568设备为例。 34 351.应用采集配置。 36 37启动SmartPerf-Device进入首页，选择测试应用、测试指标项，点击”开始测试“，拉起测试应用。 38 39 40 41 42 43 44 452.悬浮窗控制采集。 46 47点击悬浮窗”start“开始采集，单击悬浮窗”计时器“暂停采集，再次单击继续采集双击计时器，实时展示采集数据，可拖动悬浮框更改悬浮框位置，长按”计时器“，结束采集。 48 49 50 51 523.查看报告。 53 54点击“报告”，查看测试报告列表，点击“报告列表”，查看测试指标项详情。 55 56 57 58 59**SmartPerf-Daemon命令行使用示例** 60 611.进入shell, 执行查看帮助命令。 62``` 63:# SP_daemon --help 64``` 652.执行采集命令。 66``` 67:# SP_daemon -N 2 -PKG com.ohos.contacts -c -g -t -p -r 68``` 69 70**采集命令使用示例解析** 71 72| 命令 | 功能 |是否必选| 73| :-----| :--------------------- |:-----| 74| -N | 设置采集次数 |是| 75| -PKG | 设置包名 | 否| 76| -PID | 设置进程pid(对于ram适用) |否| 77| -c | 是否采集cpu | 否| 78| -g | 是否采集gpu |否| 79| -f | 是否采集fps |否| 80| -t | 是否采集温度 |否| 81| -p | 是否采集电流 |否| 82| -r | 是否采集内存 |否| 83 84**测试结果默认输出路径如下** 85``` 86报告存放路径：/data/local/tmp/data.csv 87``` 88 89
