PerfDog性能狗移动端性能测试工具

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即可停止采集信息。

Web云平台功能介绍:

• 1. 个人性能数据MyData。

  

  具体性能数据展示。

  

• 2. 测试任务管理。

  创建任务邀请测试成员加入，或加入其他人创建的测试任务中。

  

• 3. 性能数据共享归纳。

  

• 4. 测试任务性能数据Task Data。