使用指南-腾讯WeTest

安装及运行：

步骤1：登录PerfDog官网https://perfdog.qq.com/，根据您的PC平台选择想要下载的桌面应用程序

Windows平台：解压下载包，双击打开PerfDog.exe桌面应用程序。

Mac平台：直接运行dmg桌面应用程序。

备注：PerfDog采用免安装软件（绿色版）模式，想要更新软件则重新在官网下载最新版即可。

步骤2：USB连接手机，自动检测添加手机到应用列表中。

iOS：则即插即用，用户无需做任何操作。若PerfDog检测不到连接手机或无法测试，请先安装确保最新itunes是否能连上手机(最新itunes可在QQ管家上直接下载安装)。

备注：若无法使用请参考：https://bbs.perfdog.qq.com/detail-128.html

Android：有两种模式，非安装模式和安装模式。(注：请开启手机USB调试模式及允许USB应用安装。)。

a. 非安装模式：

手机即插即用，无需任何设置及安装，使用非常简单，但手机屏幕上没有实时性能数据显示。

b. 安装模式：

需要在手机上自动安装PerfDog.apk，手机屏幕上有实时性能数据显示（允许USB应用安装和PerfDog悬浮窗管理权限），启动PC版PerfDog.exe，则会在手机上自动PUSH安装PerfDog.apk，具体安装类似各个手机厂商安装第三方APP提示安装即可。（注：由于很多手机安装需要账号密码，导致无法自动安装，如果自动安装失败，则会把安装文件PerfDog.apk释放到当前文件夹里，手动安装PerfDog.apk即可）。此模式下，在测试过程中，可能由于系统资源紧缺会kill PerfDog显示app（手机界面性能数据显示），但不影响正常测试功能。

备注：若无法使用请参考：https://bbs.perfdog.qq.com/detail-128.html

步骤3：测试模式

l USB模式测试：

          USB连线后，在设备列表选择USB图标设备进行USB模式测试

l WIFI模式测试(测试功率)：

只能在WIFI模式测试功率等信息。USB连线后，在设备列表选择WIFI图标设备进行WIFI模式测试。WIFI检测连接成功后，拔掉USB连接线。（注：需要PC和被测手机连接同一WIFI，WIFI检测连接成功后，拔掉被测手机USB线(USB模式测试功率无任何意义，会充电)）(备注：一般公司WIFI可能做了安全策略限制，导致iOS平台在公司WIFI下无法使用)

步骤4：选择测试的游戏&应用

PC如图：

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

软件性能数据采集：

iOS平台（苹果官方Xcode工具参数对齐。注：iOS系统对进程性能参数做严格限制，超过限制则会被系统kill）

l ScreenShot(只支持USB模式，注：部分机型截图影响性能)

l FPS(1秒内游戏画面或者应用界面真实平均刷新次数，俗称帧率/FPS)

 Avg(FPS):平均帧率(一段时间内平均FPS)

 Var(FPS):帧率方差(一段时间内FPS方差)

 Drop(FPS):降帧次数(平均每小时相邻两个FPS点下降大于8帧的次数)

l Jank(1s内卡顿次数。iOS9.1以下系统暂时不支持。类似Android的Jank卡顿和iOS的FramePacing平滑度统计原理。帧率FPS高并不能反映流畅或不卡顿。比如：FPS为50帧，前200ms渲染一帧，后800ms渲染49帧，虽然帧率50，但依然觉得非常卡顿。同时帧率FPS低，并不代表卡顿，比如无卡顿时均匀FPS为15帧。所以平均帧率FPS与卡顿无任何直接关系)

参考：https://bbs.perfdog.qq.com/article-detail.html?id=6

PerfDog Jank计算方法：

 同时满足以下两条件，则认为是一次卡顿Jank.

a) 当前帧耗时>前三帧平均耗时2倍。

b) 当前帧耗时>两帧电影帧耗时(1000ms/24*2=84ms)。

 同时满足两条件，则认为是一次严重卡顿BigJank.

a) 当前帧耗时>前三帧平均耗时2倍。

b) 当前帧耗时>三帧电影帧耗时(1000ms/24*3=125ms)。

```
 BigJank:1s内严重卡顿次数
```

 Jank(/10min):平均每10分钟卡顿次数。

 BigJank(/10min):平均每10分钟严重卡顿次数

l Stutter(测试过程中，卡顿时长的占比)

l FTime(上下帧画面显示时间间隔，即认为帧耗时，iOS9.1以下系统暂时不支持)

```
 Avg(FTime):平均帧耗时
```

 Delta(FTime):增量耗时(平均每小时两帧之间时间差>100ms的次数)

l CPU Usage(TotalCPU表示整机CPU使用率，AppCPU表示进程CPU使用率，统计结果和Xcode一致，PerfDog使用率=Xcode使用率/核心数。备注：iOS平台CPU Usage是未规范化CPU使用率，请参考https://bbs.perfdog.qq.com/detail-146.html)

l Memory (是统计FootPrint，注：OOM与FootPrint有关，与系统、机型无关。只与RAM有关，如1G内存机器。FootPrint超过650MB，引发OOM）。注：PerfDog暂时在iOS9、10系统无法获取，其他版本ok。后续版本增加。如做性能测试，建议升级iOS系统版本

l Xcode Memory (XCode Debug gauges统计方式即XCode Memory）。注：iOS9、10系统暂时无法获取，其他版本ok。后续版本增加。如做性能测试，建议升级iOS系统版本

l Real Memory(Xcode Instrument统计方式即Real Memory，实际占用物理内存。注：物理内存系统策略有关，衡量内存指标时不会关注，但是它有助于分析定位整体性能问题。比如：footprint没有降低，说明应用没有释放内存，但是real memory却降低了，说明系统对内存做了压缩。由于压缩会占用CPU资源，同时相应会导致FPS降低)

l Virtual Memory(虚拟内存)

l Available Memory(整机可用剩余内存)

l Wakeups(线程唤醒次数。注：超过150进程很大可能会被系统kill。a sleep/wake cycle on each thread per second，Exceeding limit of 150 wakeups per second over 300 seconds，特别是iOS13.2闷杀后台进程事件，建议重点关注)

l CSwitch(上下文切换测试。注：单核超过14000进程会被系统Kill。Context Switch Limit 14000(Core/Second)

l GPU Utilization

 Render:渲染器利用率(像素着色处理阶段，若占比高，说明是PS阶段出现瓶颈，shader过于复杂或纹理大小、采样复杂等)

 Tiler: Tiler利用率(顶点着色处理阶段，若占比高，说明是VS阶段出现瓶颈，顶点数太多等原因)

 Device:设备利用率(整体GPU利用率)

l Network(Recv/Send，测试目标进程流量，统计结果合Xcode一致)（注：USB测试模式下是app的，WiFi测试模式下可能是整机可能是app）

l BTemp(电池温度)

l Battery Power(仅WIFI模式，整机实时Current电流、Voltage电压、Power功耗)（注：20s获取一次，目前最精准的统计方式，结果和Battery life结果一致，支持所有iOS机型）

注：Sum(Battery)是耗电量。

l Energy Usage(即为Xcode Energy Impact。监控应用使用的能耗情况(包括CPU、GPU、NetWork、Location、Display (iPhone X only)、Overhead)。（注：和Xcode Energy Impact结果一致。有线模式下测试，支持iOS9及以上系统。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

l Log日志采集(WIFI模式下，不支持Log收集)

Android平台

l ScreenShot(只支持USB模式，注：部分机型截图影响性能)

l FPS(1秒内游戏画面或者应用界面真实平均刷新次数，俗称帧率/FPS)

 Avg(FPS):平均帧率(一段时间内平均FPS)

 Var(FPS):帧率方差(一段时间内FPS方差)

 Drop(FPS):降帧次数(平均每小时相邻两个FPS点下降大于8帧的次数)

备注：高阶FPS功能-Android窗口与FPS

请参考https://bbs.perfdog.qq.com/?m=app&c=detail&a=index&id=201

l InterFrame(部分机型具有动态补帧/插帧技术，此参数可真实反映1秒内插入的帧数)

l Jank(1S内卡顿次数。解释说明如iOS平台说明)

```
 BigJank:1s内严重卡顿次数
```

 Jank(/10分钟):平均每10分钟卡顿次数。

 BigJank(/10分钟):平均每10分钟严重卡顿次数

l Stutter(测试过程中，卡顿时长的占比)

l FTime(上下帧画面显示时间间隔，即认为帧耗时)

```
 Avg(FTime):平均帧耗时
```

 Delta(FTime):增量耗时(平均每小时两帧之间时间差>100ms的次数)

l CPU Usage(传统CPU利用率，也叫未规范化CPU利用率，TotalCPU表示整机未规范化CPU使用率，AppCPU表示进程未规范化CPU使用率。备注：统计结果和Android Studio Profiler一致。具体参考https://bbs.perfdog.qq.com/detail-146.html)

l CPU Usage (Normalized)(规范化CPU利用率，TotalCPU表示整机规范化CPU使用率，AppCPU表示进程规范化CPU使用率。备注：建议参考规范化CPU利用率，性能参考更精准。具体参考https://bbs.perfdog.qq.com/detail-146.html)

l CPU Clock(各个CPU核心的未规范化频率和未规范化使用率)

l Memory (PSS Memory，统计结果和Android Java API标准结果一致，与Meminfo也一致。注：部分三星机器系统修改了Meminfo底层统计方式，导致Meminfo与Java AP统计结果不一致，新出三星机器已修复)

l Swap Memory (Swap Memory，部分设备支持Swap功能，在启用Swap功能后，系统会对PSS内存进行压缩，Swap增加，PSS会相应减少，由于压缩会占用CPU资源，同时相应会导致FPS降低)

l Virtual Memory(VSS)

l Available Memory(整机可用剩余内存)

l Memory Detail(NativePSS、GFX、GL、Unknown)

注：在极限测试情况下，例如开启游戏超高帧率，建议不要勾选收集Memory Usage和Memory Detail，因为部分机型会有性能损耗。

l GPU Usage(目前仅支持部分手机)。注：Top Android GPU测试机型，请参考：https://bbs.perfdog.qq.com/detail-195.html

l GPU Frequency(目前仅支持部分手机)。

l Mali GPU Utilization(仅支持Mali芯片GPU）注：支持的GPU列表，请参考：https://bbs.perfdog.qq.com/detail-332.html

    1)      Non-fragment：非片段着色器(顶点着色器，细分着色器，计算着色器)耗费的GPU时间占渲染耗费的GPU时间的比例。

    2)      Fragment：片段着色器耗费的GPU时间占渲染耗费的GPU时间的比例。

l Mali Memory & Bus Bandwidth(仅支持Mali芯片GPU）

    1)      L2Load/Store：Load/Store单元读取L2内存的实际带宽 (包括顶点缓存，原子，图像数据)。

    2)      L2Texture：Texture单元读取L2内存的实际带宽 (纹理采样)。

    3)     Bus Read：定义GPU到DRAM或者GPU外部的系统内存的实际读带宽。

    4)     Bus Write：定义GPU到DRAM或者GPU外部的系统内存的实际写带宽。

l Mali Pixels Info(仅支持Mali芯片GPU）

    1)     OverDraw：表示每个像素由多少个片段分层组成，通常用于表示像素被重复绘制的次数。

    2)     PixelsThroughput：表示每个被渲染的像素耗费的GPU的时钟的数量。

注：更多GPU信息说明，请参考：https://bbs.perfdog.qq.com/article-detail.html?id=72

l Network(Recv/Send，测试目标进程流量)（注：USB/WiFi测试模式下均为APP数据）

l CTemp(CPU温度)

l Battery Power(仅WIFI模式，Current电流、Voltage电压、Power功耗)（注：与仪器测试误差<3%左右）。注1：Sum(Battery)是耗电量。注2：对于已经兼容的双电机型，可参考：https://bbs.perfdog.qq.com/detail-340.html，未兼容设备可以电流x2进行容错。

l Log日志采集(WIFI模式下，不支持Log收集)

Web性能数据管理：

l 账户信息管理

l 性能数据管理、图表展示、编辑、大版本对比

l 性能数据统计、分析及多维度对比等

l 性能测试任务管理

软件功能介绍：

```
 性能参数控制Page：
```

点击”+ ”按钮，选择需要收集性能参数，控制性能参数显示page

```
 记录保存：
```

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

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

2）本地导出Excel文件

 记录回放（方便回看分析）：

打开要回放文件

回放结果如图：

 批注及标定(鼠标左键双击，则批注。左键双击已生成的批注，则取消。鼠标左键单击，则标定)：

 设定性能参数统计分析阈值、编辑统计参数分析及框选记录保存(对齐TDR标准)：

可以通过鼠标框选/拖动查询时间周期内，统计数据等。同时可对框选数据进行保存。右边可以设定对应的性能参数统计分析阈值等。

```
 场景Label标签：
```

通过标签按钮给性能数据打标签，鼠标左键双击颜色区域可修改对应区域标签名

```
 屏幕记录：
```

注意：截屏记录开启，影响性能

```
 多进程测试。
```

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

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

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

Android如何测试微信小游戏&小程序：https://bbs.perfdog.qq.com/article-detail.html?id=46

iOS如何测试微信小游戏&小程序：https://bbs.perfdog.qq.com/article-detail.html?id=47

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

   备注：子程序进程名高亮显示，表示当前子进程处于顶层。

FPS高阶功能(Android平台)：

满足高级用户更精准测试窗口帧率(游戏、小游戏、小程序、直播、视频类、web等所有应用都适用)。

请参考：https://bbs.perfdog.qq.com/?m=app&c=detail&a=index&id=201

```
 Log日志功能：
```

采集系统日志信息。

停止功能：

无需拔手机，StopProfilling即可停止采集信息。

自定义数据文件服务器地址，构建自己web云：

可修改数据文件服务器上传地址。Post上传http协议格式文件至自己服务器地址。

参考说明及Demo: https://bbs.perfdog.qq.com/detail-217.html

Web云平台功能介绍：

```
 个人性能数据MyData。
```

具体性能数据展示。

```
 测试任务管理
```

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

```
 性能数据共享归纳
```

```
 测试任务性能数据Task Data
```

```
 数据报告隐私分享
```

访问别人分享链接即可查看数据报告：

https://perfdog.qq.com/case_detail/367665 Password: xs2BPa

 Case报告多维度对比(详情、机型、版本、比例、区间、趋势、拖拉缩放等)。

比例、区间、趋势、拖拉缩放等对比(鼠标左右拖动性能曲线)

使用指南

相关内容