GTAndroidUserGuide
GT Android版使用说明书
腾讯科技（深圳）有限公司
版权所有侵权必究
目录
前言 (4)
安装GT (4)
GT的启动 (5)
GT退出 (5)
AUT及关注的性能指标设置 (5)
设置AUT (6)
设置关注的性能指标 (6)
输出参数 (8)
默认出参界面 (8)
出参界面展示AUT设置的性能指标 (9)
出参调整 (9)
出参数据采集 (10)
出参数据保存 (12)
出参数据展示 (12)
出参告警 (15)
输入参数 (16)
总体界面 (17)
切换到入参界面 (17)
编辑入参 (18)
编辑入参区域 (19)
悬浮图标和悬浮窗 (20)
GT悬浮图标 (21)
GT悬浮窗 (21)
功能区 (22)
出参区 (22)
入参区 (23)
开关 (24)
GT集成的测试组件 (25)
GTBattery（电量） (25)
GTPcap（抓包） (26)
GTScreenlock（wakelock控制） (28)
GTNetSwitch（网络切换） (29)
GTMemFill（内存填充） (30)
GTSdcardFill（存储填充） (31)
全局设置 (31)
悬浮窗设置 (31)
敏感度设置 (32)
日志设置 (33)
Interval设置 (33)
profiler功能 (34)
总体界面 (35)
启动/关闭性能分析（profiler） (35)
性能数据展示 (36)
日志 (39)
GT自定义日志界面主要功能 (40)
GT自定义日志搜索界面 (41)
LogCat日志主要功能 (43)
高级功能：使用GT SDK插桩调测AUT (45)
前言
GT（随身调）Android版是腾讯MIG专项测试组自行研发的Android APP随身调测平台，它是直接运行在手机上的“集成调测环境”(ITE, Integrated Test Environment)。GT Android版由两部分组成：
1. 可独立安装的GT（APK）。
2. 需要嵌入被测应用(App Under Test，以下简称AUT)代码中的GT SDK（jar包）。
之所以叫“集成调测环境”，是因为仅用GT即可独立完成如下针对AUT的测试工作：基础性能测试：手机整机或者手机上安装的任何一个APP的CPU、内存、网络流量、流畅度/帧率、电量等基础性能指标的实时展示、历史数据采集及excel格式存储、曲线绘制等。
日志查看：APP的Logcat日志查看，便于直接用手机现场定位APP功能异常、crash。
网络数据包抓包：直接用手机抓包保存成pcap文件，下载到PC后用Wireshark查看。
除了如上的GT控制台的“集成测试”能力，用户还可以将GT SDK嵌入到被测应用中，从而使用GT的如下更高级的开发调试、测试能力：
在AUT中加入各种自定义“输入参数”，从而在AUT运行时，通过GT的悬浮窗或者设置界面修改这些输入参数，实时改变AUT的能力和行为（例如，把微博客户端的单次刷新条数定义为一个GT入参），达到“开发调试”的目的。
在AUT中加入各种自定义的“输出参数”（例如，AUT的各项核心指标），从而在用户操作AUT时，实时观察AUT的这些白盒指标的变化（举例，客户端动态选择的就近接入的后台服务器地址）。
在指定的AUT代码中插入GT的代码耗时API，得到AUT运行时的某些代码片段的耗时数据，通过分析进行执行效率调优。
本说明书介绍Android GT的使用方法，包括功能介绍，界面操作和GT SDK使用介绍（结合GTDemo for Android工程演示如何使用GT SDK）。
安装GT
请像安装普通APP一样的安装GT到您的手机（注：请到GT官网下载最新版GT.apk）。
GT的启动
像启动普通APP一样的启动GT。
GT退出
在GT的一级页面中，点击手机的菜单键会弹出“Exit”选项。点击“Exit”即可退出GT。
点击“Exit”退出GT
AUT及关注的性能指标设置
启动GT后，展示的第一个页面是AUT的设置页面。如果是独立使用GT对AUT进行性能测试（不需要在AUT中嵌入GT SDK），就需要在此页面设置AUT及需要观测的基础性能指标项(CPU、CPU时间片Jiffes、NET(流量信息)、各类MEM)。
设置
AUT
设置关注的性能指标
GT 可以支持存在多个进程的AUT 的测试，可以关注AUT 每个进程的CPU 、CPU 时间片Jiffes 、内存的PSS 和内存的Private Dirty 指标，以及AUT 不区分进程的流量指标Net 。选中一个AUT 后，即可设置本次测试所关注的性能指标：
单击箭头进
入选择AUT
界面
单击QQ 浏
览器，将其作
为被测APP
如AUT 存在多个进程，而想要测试的进程的会比AUT 的启动滞后一些，此时需要在想要测试的进程启动后，点击下图的refresh 按钮，通知GT 将新启动的被测进程的性能指标也监控起来。
勾选需要关注
的关于该应用
的性能指标
项，将它（们）
注册到输出参
数列表，关于
输出参数的说
明请见后续部
分
如AUT 尚未启
动，点击
launch 按钮可
以将其启动
如AUT 已启动，显示“running ”
输出参数
GT 提供了三种测试指标或关注信息的展示方式，其中最常用的是将指标或关注信息定义为输出参数（以下简称出参），在出参界面以列表的形式展示。
默认出参界面
GT 出参界面，在不选择任何AUT 的情况下默认展示了手机整机的基础性能指标，有CPU 、内存、网络流量、信号值、流畅度/帧率。整机的CPU 指标默认放置在可用参数区域即时展示当前值，其他指标默认放置在禁用区域不关注。
入参/出参
切
点击可编辑出
参所在区域
出参数据采集
相关按钮 悬浮窗展示区
出参名称与别名
出参值
可用出参区
禁用出参区
出参界面展示AUT设置的性能指标
AUT及其关注的性能指标设置参见前一章节。AUT设置的性能指标会在出参界面以出参的形式展示：
可以看出
该被测应
用有两个
进程
流量是针对应用的，其值
比较复杂，详细见后文
出参调整
可以调整哪些出参禁用、可用、放到悬浮框展示。
出参数据采集
大部分GT 基本性能出参和通过GT SDK 在AUT 中插桩自定义的数字型出参，都可以采集其历史数据。
第一步，在未采集的状态下，勾选需要记录历史数据的出参。 可置顶
可拖动
点击edit 可进
入出参调整页 调整完成点击
done 回到出
参展示界面
第二步，点击开始采集按钮采集数据。
点击开始按钮后，会开始采集出参的历史数据。这时可以到AUT 界面开始测试AUT 。测试结束后，可点击悬浮窗上的停止按钮，或者进入出参界面，点击停止按钮。停止后，可以保存采集的历史数据。
全选/全不选
选中后，本条出参的
历史数据在开始采集
后会被记录
点击开始/停止记
录历史数据
出参数据保存
停止采集后，可以一键保存和删除所有勾选的出参的历史数据。
点击保存按钮时输入的名称为本次测试数据存放的目录名。数据默认保存在SD 卡上的GT/GW/
在出参区域为非编辑状态，出参所在区域为非禁用出参区域，且有历史数据的情况下，点击此条出参，可以进入出参数据展示界面。
保存按钮，点击一键保存
本次测试所有勾选的历
史数据
清空按钮，点击一键清空
所有勾选的历史数据
历史数据图表默认显示最近不超过50条的记录，想查看最近50条之前的记录请拖动图表。在图表上长按并滑动可以显示具体一条记录的详细信息。点击保存按钮可单独保存该出参信息，保存位置与命名方式和一键保存相同。
长按曲线展示区域，可查看某个点的值。
可左右滑动;
可长按看具体值;
横坐标为序号和时间;
纵坐标为值;
该出参历史记录可单
独保存或删除
总体指标区，从上到下，从左到右的顺
序分别为当前出参值、采集记录总数、
平均值、最大值和最小值
告警设置区
长按出现竖线，中间文
字内容为对应点的时
间、序号和值
目前除了AUT 内存的PSS/Private Dirty 和信号值，包括CPU/Jiffes/帧率/流量信息等其他采集到的数据展示都类似上述图中的曲线，其中流量信息在点击删除按钮时会同时归0。流量数据展示：
AUT 内存的PSS/Private Dirty 和信号值的数据展示界面同时有多条曲线，以PSS 为例，其展示界面会同时展示PSS 的Total/Dalvik/Native 三个值的曲线（注：内存的PSS/Private 都区分Total/Dalvik/Native 三个值，与Android 手机的meminfo 信息对应）。
删除的同时可归0
t 表示发送的数据量，r 表示接收的
数据量。曲线图上是所有类型
（WIFI/3G/2G ）发送或接收的数据
量总和
总体指标区的展示对应项，会根据该下
拉菜单选择的关注子项不同而变化
出参告警
在出参数据展示页可以设置持续一段时间，值不在设置的阈值范围内时的告警提示。告警提示的方式为通知栏文字变化+鸟鸣声+震动+出参和GT 图标变为桔色。
点击打开或收起告警区域。收起时关闭告警功能 设置出参的正
常范围
设置连续时间，
出参值连续超过这个时间不在正常范围时会告警
输入参数
输入参数（以下简称“入参”）为用户自定义的插入到被测应用程序代码里的一种桩，可以在运行时改变被测代码里参数的值。
举个例子：比如被测代码里有些参数需要调优时，可以通过入参随时对这些参数进行修改，对比不同参数值下的效果（核心指标可以用出参实时展示出来），详细请参考《GT API UserGuide for Android 》。
需要说明的是，悬浮窗上最多同时显示3 个入参。所有入参都可以在GT 主界面的入参子界面中看到，并可以在子界面调整显示在悬浮窗上的入参具体项。参见悬浮窗章节；
告警状态。
点击出参进
入查看并清
除告警状态
总体界面
切换到入参界面
点击T ag 键“Para.”即可进入出入参界面，默认是出参界面。点击in 切换到入参界面。 悬浮窗展示区 可用入参区 禁用入参区
入参值
入参名称
入参出参切换点击可编
辑入参所
在区域
点击切换入参出参点此T ab进入出入参界面
编辑入参
点击一条入参，进入入参值编辑界面，修改入参的值。
点此入参进入编辑界面
编辑入参区域
入参区域分为悬浮窗展示区，可用入参区，禁用入参区。
悬浮窗展示区的入参可以显示在悬浮窗上，通过操作悬浮窗快速进行编辑。可用入参区的入参不展示在悬浮窗上，但是仍然起作用。禁用入参区的入参不起任何作用。 点击右上角的编辑按钮，可以将入参区域切换到编辑状态。
编辑状态下，可按住一条入参右端的拖动按钮，将其移动到其他入参区域。比如从禁用入参区拖入到可用入参区，这样原来不起任何作用的入参就起作用了。
点击切换入参区
域编辑状态
悬浮图标和悬浮窗
可置顶
可拖动
长按悬浮图标，打
开/关闭悬浮窗