PerfDog性能狗帮助文档

网址：https://perfdog.qq.com/

重要提示：

1. Windows & Mac OS X平台PerfDog客户端版本都支持用户对iOS和Android设备进行测试。PC上PerfDog可多开，单PC可同时测试多台手机。
2. PerfDog支持移动平台所有应用程序（游戏、APP应用、浏览器、小程序、小游戏、H5、后台系统进程等）及Android模拟器性能测试。
3. 支持APP多进程测试，如Android多子进程及iOS扩展进程APP Extension。
4. iOS平台：iPhone小圆点/辅助触控（AssistiveTouch）及iPhone x刘海手机的小白条/引导式访问（Guided Access）影响PerfDog(性能狗)采集数据准确性，请关闭。
注：应用、游戏中关闭小白条/引导式访问（Guided Access）方法：
1. 点击【设置】-【通用】-【辅助功能】-【引导式访问】
2. 开启【引导式访问】，进入游戏后，连按三下电源键，可彻底隐藏home键。
3. 若想恢复home键，再按三下电源键即可恢复。
5. 截屏记录、Log日志收集会影响性能(整体FPS影响<=1。小米5:CPU=1%左右。iPhone7P:CPU<2%)，若无需请不要开启截屏或Log日志收集。
6. 提示网络连接失败问题可能是PC网络设置了网络代理或启用了抓包软件，请关闭。
7. PerfDog无法检测到手机

Android平台：

1）请开启Debug调试模式(华为设备，需要先开启开发者选项中的 "仅充电"模式下允许ADB调试选项，再开启usb调试)。

2）以上还不行，请重新打开PerfDog软件及重启手机。

3）以上还不行，请确认PC上ADB可能被独占(自动化测试框架、Android Studio工具等)，请关闭工具及ADB.exe。

4）以上还不行，请用手机管家或手机助手检测下。

iOS平台：

1）需要手机信任。

2）以上还不行，请用itunes软件检测下是否可以连接检测到手机。

3）以上还不行，请重启手机及换USB线(可能USB线老化)。

4）以上还不行，请重启手机。
8. 如何收集更多性能参数?
UI右下方+号按钮，自定义性能参数。勾选表示收集，选中对应框表示显示。
9. 为什么我看不到GPU信息?
Android平台，目前只支持部分高通GPU手机，后期陆续补全。
10. 为什么手机无法测试电量功率?
只能在WIFI模式下测试电量，USB模式有充电测试无意义。iOS平台下，有无线充电功能手机暂时不支持。
11. 为什么无法截图?
只在USB模式可使用。
12. 为什么手机上看不到性能信息?
请打开手机悬浮窗口显示权限。
13. 目前不支持win32系统，后期会支持。
14. 各种提示，反正无法使用
请重启手机或换USB线，重启是万能的。
15. Android云真机测试流程
手机云真机平台ADB远程调试->Copy远程调试ADB命令信息->本地cmd命令窗口输入刚Copy的ADB命令->回到手机云真机平台确认授权->PerfDog选择云真机测试。
16. Android模拟器测试和Android云真机测试流程类似。
17. Android手机WIFI模式连接失败？
部分华为、OPPO手机请在仅充电模式下，进行WIFI模式连接。
18. iOS手机内存采集一直为0，请重启手机，Energy采集一直是0，请重启测试的APP应用或者游戏。
19. Mac11.15系统，需要做安全设置，否则会误报PerfDog为恶意软件，具体设置方法为：打开系统设置->安全性与隐私->通用->点击仍然打开。
20. 无法删除PerfDog文件夹，请任务管理器关闭Adb.exe进程。

致移动游戏&应用性能测试分析的伙伴们：

你是否会因移动游戏&APP性能问题，而备受煎熬？
你又是否因寻找性能测试分析工具，而彷徨迷茫？
你是否因工具需要，而尝试各种ROOT/越狱？
你是否因工具准确性，而被逼各类花式复测验证？
你是否因工具局限性，而同时开启N个工具？
你又是否因工具空白，而被迫各式XCode源码编译？
ROOT/越狱越来越难，你我路在何方？
版本编译坑罗密布，你我又将守夜到何时？
…
备受煎熬的时候一去不复返了，
因为移动全平台性能测试分析神器来了，
它为移动游戏&APP测试分析而生，
它就是PerfDog性能狗！

背景：

在项目研发支持过程中，经历如上障碍和痛苦。我们决定做一个完全独立、简单易用，与APP版本、系统版本、系统平台无任何关系的性能平台。

为了保证测试结果的准确性、严谨性和可对比性。我们编写了Demo进行测试对比。

1. iOS平台：

PerfDog测试数据结果与XCode/Instrument（苹果官方工具需要游戏源码编译测试）测试结果对齐一致。性能影响结果：Xcode/Instrument性能影响较大，PerfDog性能影响很小。

2. Android平台：

安卓平台比较关注的是工具本身对手机性能影响，我们在小米5手机上锁死最低频率。开启截图测试影响结果如下：

PerfDog性能影响：CPU占比6%-10%（正常频率下CPU占比1-3%）。

其他工具性能影响：CPU占比27%-33%。

备注：

工具本身性能若影响大的话，手机容易发热，同时对游戏&应用性能有很大影响。即测试出性能数据无法反映用户真实情况。

软件性能数据采集：

PerfDog支持移动平台所有应用程序（游戏、APP应用、浏览器、小程序等）及Android模拟器，桌面应用程序PerfDog支持在Windows和Mac机器使用运行。在iOS和Android平台获取性能参数如下：

iOS平台（与苹果官方Xcode工具参数对齐一致）

Screenshot
FPS(1秒内游戏画面或者应用界面真实平均刷新次数，俗称帧率/FPS)
   1) Avg(FPS):平均帧率(一段时间内平均FPS)
   2) Var(FPS):帧率方差(一段时间内FPS方差)
   3) Drop(FPS):降帧次数(平均每小时相邻两个FPS点下降大于8帧的次数)
Jank(1s内卡顿次数。iOS9.1以下系统暂时不支持。类似Android的Jank卡顿和iOS的FramePacing平滑度统计原理。帧率FPS高并不能反映流畅或不卡顿。比如：FPS为50帧，前200ms渲染一帧，后800ms渲染49帧，虽然帧率50，但依然觉得非常卡顿。同时帧率FPS低，并不代表卡顿，比如无卡顿时均匀FPS为15帧。所以，平均帧率FPS与卡顿无任何直接关系)
    PerfDog计算方法：同时满足两条件，则认为是一次卡顿Jank.
    1、当前帧耗时>前三帧平均耗时2倍。
    2、当前帧耗时>两帧电影帧耗时(1000ms/24*2=84ms)。
    同时满足两条件，则认为是一次严重卡顿BigJank.
    1、当前帧耗时>前三帧平均耗时2倍。
    2、当前帧耗时>三帧电影帧耗时(1000ms/24*3=125ms)。
计算思路：考虑视觉惯性，假设以前三帧的平均帧耗时为参考，作为vsync时间间隔，连续两次vsync没有新渲染画面刷新，则认为是一次潜在卡顿，也就是说下一帧耗时大于前三帧平均帧耗时2倍，则认为一次潜在卡顿。同时单帧耗时满足大于两倍电影帧耗时1000ms/24*2 (由于人眼低于24帧才能辨别画面不连续性)，则认为是一次真正卡顿。同时若单帧耗时大于3倍电影帧耗时，则认为是一次严重卡顿。
注解：为什么是两次vsync？GPU一般是3重缓冲buffer，当前帧已占用一个buffer，即剩余2缓冲buffer，人眼一般可容忍2帧延迟。为什么是两帧电影帧耗时？低于24帧画面，人眼就能感知到画面不连续性，电影一般都是24帧。即电影帧耗时1000ms/24=41.67ms，两帧电影帧耗时也就是41.67ms*2，三帧电影帧耗时是41.67ms*3。
   1) BigJank:1s内严重卡顿次数
   2) Jank(/10min):平均每10分钟卡顿次数。
   3) BigJank(/10min):平均每10分钟严重卡顿次数
FTime(上下帧画面显示时间间隔，即认为帧耗时，iOS9.1以下系统暂时不支持。)
1) Avg(FTime):平均帧耗时
2) Delta(FTime):增量耗时(平均每小时两帧之间时间差>100ms的次数)
CPU Usage(Total整机/App进程，统计结果合Xcode一致)
Memory (是统计FootPrint，注：OOM与FootPrint有关，与系统、机型无关。只与RAM有关，如1G内存机器。FootPrint超过650MB，引发OOM）。受iOS平台限制，暂时无法获取ios10及以下系统的memory。后续版本增加。如做性能测试，建议升级iOS系统版本
Xcode Memory (XCode Debug Gauges统计方式即XCode Memory）。受iOS平台限制，暂时无法获取ios10及以下系统的Xcode Memory。后续版本增加。如做性能测试，建议升级iOS系统版本
Real Memory(Xcode Instrument统计方式即Real Memory，实际占用物理内存。注：物理内存与系统策略有关，关注意义不大)
Virtual Memory(虚拟内存)
Wakeups(线程唤醒次数)。注：超过150进程很大可能会被系统kill
CSwitch(上下文切换测试)。注：单核超过14000进程会被系统Kill
GPU Utilization(Render/Tilter/Device）
   1) Render：渲染器利用率(像素着色处理阶段，若占比高，说明是PS阶段出现瓶颈，shader过于复杂或纹理大小、采样复杂等)
   2) Tilter:Tilter利用率(顶点着色处理阶段，若占比高，说明是VS阶段出现瓶颈，顶点数太多等原因)
   3) Device:设备利用率(整体GPU利用率)
Network(Recv/Send，测试目标进程流量，和Xcode结果一致)
Battery Power(整机实时Current电流、Voltage电压、Power功率)（注：和Xcode Instrument结果一致）
Energy Usage(即为Xcode Energy Impact。监控应用使用的能耗情况(包括CPU、GPU、NetWork、Location、Display (iPhone X only)、Overhead)。（注：和Xcode Energy Impact结果一致。有线模式下测试。Total Energy<270为Low，270 < Total Energy < 1000为High，Total Energy>1000为Very High）。
参考：https://help.apple.com/xcode/mac/11.0/index.html?localePath=en.lproj#/devf7f7c5fcd
Log(系统调试日志信息)

Android平台

Screenshot
FPS(1秒内游戏画面或者应用界面真实平均刷新次数，俗称帧率/FPS)
   1) Avg(FPS):平均帧率(一段时间内平均FPS)
   2) Var(FPS):帧率方差(一段时间内FPS方差)
   3) Drop(FPS):降帧次数(平均每小时相邻两个FPS点下降大于8帧的次数)
Jank(1s内卡顿次数。解释说明如iOS平台说明)
   1) BigJank:1s内严重卡顿次数
   2) Jank(/10分钟):平均每10分钟卡顿次数
   3) BigJank(/10分钟):平均每10分钟严重卡顿次数
FTime(上下帧画面显示时间间隔，即认为帧耗时)
1) Avg(FTime):平均帧耗时
2) Delta(FTime):增量耗时(平均每小时两帧之间时间差>100ms的次数)
CPU Usage(Total整机/App目标进程，统计结果和Android Studio Profiler一致)
CPU Clock(各个CPU核心的频率和使用率)
Memory (PSS Memory，统计结果和Android Java API标准结果一致，与Meminfo也一致。注：部分三星机器系统修改了Meminfo底层统计方式，导致Meminfo与Java AP统计结果不一致，新出三星机器已修复)
Swap Memory (Swap Memory)
Virtual Memory
Memory Detail(NativePSS、GFX、GL、Unknown)
GPU Usage(目前仅支持高通芯片手机)
GPU Frequency(目前仅支持高通芯片手机)
Network(Recv/Send)
CTemp(CPU温度)
Battery Power(Current电流、Voltage电压、Power功率)（注：与仪器测试误差<3%左右）
Log(系统调试日志信息)

Web性能数据管理：

账户信息管理
性能数据管理、图表展示、编辑、版本对比
性能测试任务管理

使用步骤：

步骤1 : Window PC/苹果Mac机器上安装、运行PerfDog客户端。

iOS：若PerfDog检测不到连接手机或无法测试，请先安装确保最新iTunes是否能连上手机。

Android：请开启手机Debug调试模式及允许USB安装。
步骤2 : 启动PerfDog，然后USB连接手机，自动检测添加手机到应用列表中。

iOS：则即插即用，用户无需做任何操作。

Android：有两种模式，非安装模式和安装模式。
- a. 非安装模式：
  
  手机即插即用，无需任何设置及安装，使用非常简单，但手机屏幕上没有实时性能数据显示。
- b. 安装模式：
  
  需要在手机上自动安装PerfDog.apk，手机屏幕上有实时性能数据显示。（请开启Debug调试模式、允许USB安装和PerfDog悬浮窗管理权限），启动PC版PerfDog.exe，则会在手机上自动PUSH安装PerfDog.apk，具体安装类似各个手机厂商安装第三方APP提示安装即可。（注：由于很多手机安装需要账号密码，导致无法自动安装，如果自动安装失败，则会把安装文件PerfDog.apk释放到当前文件夹里，手动安装PerfDog.apk即可）。
这里重点说明下Android平台下，LMK和Swap这两个参数意义：

LMK：Android平台下OOM与游戏进程内存大小无关，主要是系统剩余物理内存有关。系统剩余物理内存小于LMK，则会引起OOM。

Swap：系统进程用到zram/vnswap内存压缩技术。不同手机系统启用Swap memeroy大小不同。
步骤3 : 测试模式。
- USB模式测试：
  
  USB连线，在设备列表选择USB图标设备进行USB模式测试(插线模式测试功率无任何意义)。
- WIFI模式测试(测试功率)：
  
  USB连线后，在设备列表选择WIFI图标设备进行WIFI模式测试。WIFI检测连接成功后，拔掉USB连接线。（注：需要PC和被测手机连接同一WIFI，WIFI检测连接成功后，拔掉被测手机USB线(插线模式测试功率无任何意义)）。
步骤4 : 选择测试的游戏&应用。

PC如图：

Android平台，安装模式下，手机屏幕左上角有实时性能数据显示（Android手机请打开PerfDog悬浮窗管理权限，否则手机上不会显示性能参数）。

功能介绍：

1. 性能参数控制Page：

选择需要收集性能参数，控制性能参数显示page。
2. 记录保存：

测试结束时，可自主选择两种方式保存处理(Upload/Save)性能数据：

1）将性能数据同步上传PerfDog云端web看板。

2）本地导出Excel文件。
3. 记录回放（方便回看分析）：

打开要回放文件。

回放结果如图：
4. 批注及标定：

鼠标左键双击，增加批注，再次双击，则取消批注。鼠标左键单击，则增加标定，再次点击则重新标定。
5. 设定性能参数统计分析阈值、编辑统计参数分析及框选记录保存：

可以通过鼠标框选/拖动查询时间周期内，统计数据等。同时可对框选数据进行保存。工具左侧“Setting”以设定对应的性能参数统计分析阈值等。
6. 场景Label标签：

通过标签按钮给性能数据打标签，鼠标左键双击颜色区域可修改对应区域标签名。
7. 屏幕记录：

注意：截屏记录开启，影响性能。
8. 多进程问题测试：

iOS平台，APP多进程分为APP Extension和系统XPC Server。

比如：企鹅电竞直播软件用到APP Extension扩展进程(扩展进程名LABroadcastUpload)。当然也可能用到系统XPC Server服务进程，如一般web浏览器会用到webkit。

Android平台，一般大型APP，比如游戏有时候是多进程协作运行（微信小游戏，微视等APP及王者荣耀等游戏多子进程），可选择目标子进程进行针对性测试。默认是主进程。如图王者荣耀。

微信小游戏、小程序测试等，如下是微信小游戏-浪漫玫瑰园：

备注：子程序进程名高亮显示，表示当前子进程处于顶层。
9. Log日志功能：

采集系统日志信息。
10. 停止功能：

无需拔手机，选择Stop Profilling即可停止采集信息。