Android ADB 命令总结

概要
1.什么是adb？
ADB，即 Android Debug Bridge (安卓调试桥)是一种允许模拟器或已连接的 Android 设备进行通信的命令行工具，它可为各种设备操作提供便利，如安装和调试应用，可以在Android SDK/platform-tools中找到 adb 工具。
2.adb工作原理

上图是一个简单的adb工作原理图。adb客户端服务器端程序，由上图可以看出它主要三个组件组成：Client，Server，Daemon。
（1）当你启动一个adb Client（客户端），Client首先会选确认是否已有一个adb Server（服务器）进程在运行，如果没有，则会启动Server进程。此时，adb Server就会绑定本地的TCP端口5037（所有的adb客户端都使用5037端口与adb服务端通信），并监听adb Client发来的命令。
（2）接着，Server将会扫描所有5555到5585范围内的奇数端口来定位所有的模拟器或设备，并与之建立连接。一旦Server找到 了adb daemon（守护程序），它将建立一个到该端口的连接，这样，我们就可以使用adb命令控制和访问模拟器或设备了。在这里，需注意的是任何模拟器或设备实例会取得两个连续的端口：一个偶数端口用来响应控制台的连接，和一个奇数端口用来响应adb连接。即如果模拟器与adb在5555端口连接，则其与控制台的连接就是5554端口。
当服务端与所有的模拟器建立连接之后，就可以使用adb命令来控制或者访问了。因为服务端管理着连接并且可以接收到从多个adb客户端的命令，所以可以从任何一个客户端或脚本来控制任何模拟器或手机设备。

3.adb的作用
借助adb工具，我们可以管理设备或手机模拟器的状态，还可以进行很多手机操作，如安装软件、系统升级、运行shell命令等等。简而言之，adb就是连接Android手机和PC端的桥梁，可以让用户在电脑上对手机进行全面的操作。
ADB 是 Android SDK 里的一个工具, 用这个工具可以直接操作管理Android模拟器或者真实的Android设备。此处可以想象各种手机刷机工具。它可以：
1、打开手机的shell命令，进入手机的底层系统
2、将本地APK软件安装到模拟器或Android设备上
3、管理Android模拟器或者真实的Android设备重启，设置端口等操作
4、可以将PC端文件上传到设备或将设备中文件下载到PC

ADB程序包括三个组件，分别为：（记一下）组成部分
客户端：运行在开发用的电脑上，可以在命令行中运行adb命令来调用该客户端。
服务端部分：是运行在开发用电脑上的后台进程，用于管理客户端与运行在模拟器或真机的守护进程通信。
守护进程部分：运行于模拟器或手机的后台。

安装
1.下载ADB工具包
网上搜一下便可以找到，也可以在网盘获取：链接：https://pan.baidu.com/s/1tElgryyIuKRJ3h1PPSgGLw 密码：reop
2.将下载后的文件解压，即可看到adb.exe，这就是可执行文件。

3.将adb.exe文件的路径添加到环境变量。
注：Sdk依赖于java，adb属于sdk，所以使用adb的前提必须是已经配置好了jdk和sdk的环境变量。
例如：我的adb.exe的路径为D:sdkAndroid_SDK_windowssdkplatform-tools，将这路径加入环境变量

4.测试
win+R，打开命令提示符，输入adb，若出现很多adb的说明，就说明环境变量没问题，如图：

连接设备
1.USB数据线连接
win10下USB连接Android
1.手机端的设置，以红米4为例：
a.打开开发者模式，小米手机打开开发者模式方法为，连续点击MIUI版本，就可以进入开发者模式；
b.进入开发者选项，开启USB调试，开启USB调试（安全设置）允许通过USB调试修改权限或模拟点击。
2.用USB线将电脑和手机连接起来，在电脑端打开任务管理器，若发现360.手机助手在运行，将它关闭，因为360手机助手和adb用的是同一个端口，
3.终端运行
adb devices
出现下图，即为连接成功：

测试返回键，终端运行
adb shell input keyevent 4
若手机有反应，即可对手机进行各种操作。
2.WiFi连接
win10下Wifi连接Android
参考链接：http://blog.csdn.net/YSSJZ960427031/article/details/50864903
前提：Android 设备与将运行 adb 的电脑连接到同一个局域网，比如连到同一个 WiFi。
1.USB连接手机和电脑；
2.运行 adb devices，测试是否连接成功，能出现设备列表即可；
3.运行
adb tcpip 5555
然后断开 USB 连接。
4.通过手机状态信息，查看手机的IP地址，一般会在【设置】-【关于手机】-【状态信息】找到IP地址。
5.运行
adb connect 192.168.2.100
若出现：
connected to 192.168.2.100:5555
说明连接成功。
3.连接模拟器命令
安卓连接mumu模拟器：
adb connect 127.0.0.1:7555
安卓连接yeshen模拟器：
adb connect 127.0.0.1:62001
常用命令
1、启动adb服务
adb start-server
2、终止adb服务
adb kill-server
3、进入adb运行环境
adb shell
4、获取帮助 里面有adb的各种命令和参数的介绍
adb help
5、查看adb版本
adb version
6、以root权限重启adb
adb root
7、将system分区重新挂在为可读写分区，此命令在操作系统目录时很重要
adb remount
8、重启设备,可选参数进入bootloader(刷机模式)或recovery(恢复模式)
adb reboot [bootloader|recovery]
系统相关
1、查看设备名称，豌豆荚等应用就是通过此来获得设备的名称

 adb shell cat /system/build.prop

结果：

2、查看手机分辨率有两种方法，第二种方法最为简洁
注意：'grep' 不是内部或外部命令，也不是可运行的程序或批处理文件
 
2.1
adb shell dumpsys window | grep Surface（记一下）
grep是一个非常有用的参数,具体含义和用法大家自行google一下,试验结果为1080 * 1920:

2.2
adb shell wm size
返回结果为:

adb shell wm size 480x1024
表示将分辨率修改为 480px * 1024px。
恢复原分辨率命令：
adb shell wm size reset
3、查看手机sdk版本
adb shell getprop | grep version
运行上面的命令后，列出来的version中[ro.build.version.release]: [6.0.1]即为手机sdk版本
4、查看手机型号信息
adb shell getprop | grep product
运行此命令之后，能看到product,board,brand和cpu等等的型号
5、获取序列号，获取到的序列号即为adb devices列出来的序列号
adb get-serialno
6、查看连接的设备
adb devices
如果有多个设备连接，想对其中的某一设备进行操作，就需要在此 命令的后面加参数

假如有两个真机连接了我ad的电脑，adb devices获取到的数据如下

进入1b71651设备的命令为:
adb -s 1b71651 shell
7、查看wifi密码(需要root权限)
adb shell cat data/misc/wifi/*.conf
8、查看wifi_mac信息
adb shell cat /sys/class/net/wlan0/address
运行此命令得到结果：93:a1:a2:91:d1:c1就是设备的wifi_mac地址
9、查看后台services信息
adb shell service list
运行结果为：

10、查看系统当前内存占用，为综述
adb shell cat /proc/meminfo
运行结果为：

11、查看各进程详细内存占用和系统的内存占用有几种方法
11.1
adb shell dumpsys(读取） meminfo（查看内存信息）

Total PSS 信息就是你的应用真正占据的内存大小，通过这个信息，可以轻松判别手机中哪些程序占内存比较大。
11.2 查看各进程内存的另一方法 不是所有设备都支持
adb shell procran

其中：

11.3 查看设备上进程的cpu和内存占用情况（记一下）

adb shell 

adb shell dumpsys

Android提供的dumpsys工具用于查看感兴趣的系统服务信息与状态。

参考下表：

12、查看系统耗电情况，并导出

adb shell dumpsys batterystats（状态） > xxx.txt

13、查看系统设置的闹钟

adb shell dumpsys alarm

14、查看系统的wakelock,不合理的使用wakelock会导致系统耗电加剧

adb shell dumpsys power

解释：

wakelock是一种锁的机制，只要有应用拿着这个锁，CPU就无法进入休眠状态，一直处于工作状态。比如，手机屏幕在屏幕关闭的时候，有些应用依然可以唤醒屏幕提示用户消息，这里就是用到了wakelock锁机制，虽然手机屏幕关闭了，但是这些应用依然在运行着。手机耗电的问题，大部分是开发人员没有正确使用这个锁，成为"待机杀手"。

15、获取手机系统信息（ CPU，厂商名称等）

adb shell "cat /system/build.prop | grep "product""

16、获取手机系统api版本

adb shell getprop ro.build.version.sdk

17、获取序列号—两种方式

1、adb get-serialno

2、adb shell getprop ro.serialno

02ae0c1021089daf

18、查看屏幕密度（记一下）

命令：

adb shell wm density

Physical density: 480

adb shell wm density 160

表示将屏幕密度修改为 160dpi。

恢复原屏幕密度命令：

adb shell wm density reset

19、获取手机的IMEI（国际移动设备识别码（International Mobile Equipment Identity number，IMEI），俗称“手机串号”、“手机串码”、“手机序列号”，用于在GSM移动网络中识别每一部独立的手机，相当于手机的身份证号码。IMEI码适用于GSM和WCDMA制式的移动电话和铱星卫星电话，而CDMA手机采用MEID码，与IMEI码有所区别。）

有三种方式，由于手机和系统的限制，不一定获取到

1、 adb shell dumpsys iphonesubinfo

其中Device ID即为IMEI号

2、 adb shell getprop gsm.baseband.imei

3、 service call iphonesubinfo 1 

此种方式，需要自己处理获取的信息得到

IMEI(International Mobile Equipment Identity)是国际移动设备身份码的缩写，国际移动装备辨识码，是由15位数字组成的"电子串号"，它与每台手机一一对应，而且该码是全世界唯一的。每一只手机在组装完成后都将被赋予一个全球唯一的一组号码，这个号码从生产到交付使用都将被制造生产的厂商所记录

IMEI俗称“串号”，存储在手机的EEPROM（俗称“码片”）里

IMEI分配：

IMEI码由GSM（全球移动通信协会）统一分配，授权BABT（英国通信认证管理委员会）审受

IMEI的组成:

IMEI由15位数字组成，其组成为：　　

1、前6位数（TAC，Type Approval Code)是"型号核准号码"，一般代表机型

2、接着的2位数（FAC，Final Assembly Code)是"最后装配号"，一般代表产地

3、之后的6位数（SNR)是"串号"，一般代表生产顺序号

4、最后1位数（SP)通常是"0"，为检验码，目前暂备用。

IMEI码具有唯一性，贴在手机背面的标志上，并且读写于手机内存中。它也是该手机在厂家的"档案"和"身份证号"。

应用场景:

我们在应用程序需要对用户提交的信息加密时，由于手机的IMEI号码是唯一的(相当于身份证或者指纹的作用)，所以我们进行加密的时候可以在需要加密的信息后加上手机的IMEI号码，从而加大算法的复杂度.

12、导出设备信息（记一下）

adb get-serialno > 序列号.txt

adb shell cat /sys/class/net/wlan0/address > MAC地址.txt

adb shell getprop ro.product.model > 设备型号.txt

adb shell getprop ro.build.version.release> 系统版本.txt

adb shell pm list packages -s > 系统应用的所有包名.txt

adb shell pm list packages -3 > 第三方应用包名.txt

adb shell wm size > 屏幕分辨率.txt

adb shell wm density > 屏幕密度.txt

adb shell cat /proc/cpuinfo > CPU信息.txt

adb shell pm list permissions -f > 权限.txt

adb shell pm list users -f > 用户.txt

文件操作相关:

1、拷贝文件/目录到设备（记一下）

adb push <local>...<remote>

解释：<local>:电脑端文件地址、<remote>:设备文件存放地址

2、从设备拷贝文件/目录，-a参数保留了文件的时间戳和模式

adb pull [-a] <remote>...<local>

3、列出目录下的文件和文件夹，可选参数-al可查看文件和文件夹的详细信息

adb shell ls [-al]

4、进入文件夹

adb shell cd <folder>   #<folder>文件夹名称

5、查看文件

adb shell cat <filename>  #<filename>文件名称

6、重命名文件

adb shell rename path/oldfilename  path/newfilename

7、删除文件/文件夹

adb shell rm path/filename

-r 可选参数用于删除文件夹及下面的所有文件 eg:adb shell rm -r <folder>

8、移动文件

adb shell mv path/filename newpath/filename

9、拷贝文件

adb shell cp file newpath/file1

10、创建目录

adb shell mkdir path/folder

11、设置文件最高读写权限

adb shell chmod 777 filename

12、手机未root 查看data/data/某一app文件信息

如果设备没有root，但是又想方便地查看data/data/目录下的一些文件，直接进入data会提示没有权限,查看的方式为进入data/data/后,运行下面的命令，就能直接进入你应用的包下了,可通用cp或者mv拷贝或移动到sdcard目录进行其他操作

run-as package_name

数据库相关

数据库的操作和今天的主题关系不大，增删改查操作不再列举。但是平时的开发过程中只是查看数据库中某个表或者某个字段，也无需每次都pull出来之后再查看，用命令行会更加方便快捷,进入到test.db的目录后，运行如下命令

1、操作db

sqlite3 external.db

2、对db使用sqlite3命令后，通过.help查看各种使用指导

.help

3、列举数据库的table名称

.tables

4、列表数据库的schema，个人觉得下面两个命令很有用，效果等同，可以方便快捷地查看数据库字段对应的数据类型，

.schema更加简洁

.schema

或者：

select * from sqlite_master where type = "table";

logcat日志相关

1、解析 adb logcat 的帮助信息（重要，记一下）

adb logcat , 打印 Android 的系统日志

adb bugreport , 打印dumpsys、dumpstate、logcat的输出，也是用于分析错

在命令行中输入 adb logcat –help 命令, 就可以显示该命令的帮助信息;

adb logcat 命令格式 : adb logcat [选项] [过滤项], 其中 选项 和 过滤项 在 中括号 [] 中, 说明这是可选的;

 (1) 选项解析

选项解析 : 

– ”-s”选项 : 设置输出日志的标签, 只显示该标签的日志;

–”-f”选项 : 将日志输出到文件, 默认输出到标准输出流中, -f 参数执行不成功;

–”-r”选项 : 按照每千字节输出日志, 需要 -f 参数, 不过这个命令没有执行成功;

–”-n”选项 : 设置日志输出的最大数目, 需要 -r 参数, 这个执行 感觉 跟 adb logcat 效果一样;

–”-v”选项 : 设置日志的输出格式, 注意只能设置一项;

–”-c”选项 : 清空所有的日志缓存信息;

–”-d”选项 : 将缓存的日志输出到屏幕上, 并且不会阻塞;

–”-t”选项 : 输出最近的几行日志, 输出完退出, 不阻塞;

–”-g”选项 : 查看日志缓冲区信息;

–”-b”选项 : 加载一个日志缓冲区, 默认是 main, 下面详解;

–”-B”选项 : 以二进制形式输出日志;

– ”raw”格式 : 只输出日志信息, 不附加任何其他 信息, 如 优先级 标签等, 使用adb logcat -v raw 命令;

– ”time”格式 : ”日期 时间 优先级 / 标签 (进程ID) : 进程名称 : 日志信息 “, 使用adb logcat -v time 命令;

– ”long”格式:” [ 日期 时间 进程ID : 线程ID 优先级 / 标签] 日志信息 “, 输出以上提到的所有的头信息, 使用adb logcat -v long 命令;

– ”tag”格式 : ” 优先级 / 标签 : 日志信息”, 使用adb logcat -v tag 命令;

清空日志缓存信息 : 使用 adb logcat -c 命令, 可以将之前的日志信息清空, 重新开始输出日志信息;

将缓存日志输出 : 使用 adb logcat -d 命令, 输出命令, 之后推出命令, 不会进行阻塞;

输出最近的日志 : 使用adb logcat -t 5 命令, 可以输出最近的5行日志, 并且不会阻塞;

(2) 过滤项解析（重要，记一下）

过滤项格式 : <tag>[:priority] , 标签:日志等级, 默认的日志过滤项是 ” *:I ” ;

– V : Verbose (明细);

– D : Debug (调试);

– I : Info (信息);

– W : Warn (警告);

– E : Error (错误);

– F: Fatal (严重错误);

– S : Silent(Super all output) (最高的优先级, 可能不会记载东西);

过滤指定等级日志 : 使用 adb logcat 10 *:E 命令, 显示 Error 以上级别的日志;

过滤指定标签等级日志 : 使用 adb logcat WifiHW:D *:S 命令进行过滤;

– 命令含义 : 输出10条日志, 日志是 标签为 WifiHW, 并且优先级 Debug(调试) 等级以上的级别的日志;

–注意 *:S : 如果没有 *S 就会输出错误;

可以同时设置多个过滤器 : 使用adb logcat WifiHW:D dalvikvm:I *:S 命令, 输出 WifiHW 标签 的 Debug 以上级别 和 dalvikvm 标签的 Info 以上级别的日志;

2. 使用管道过滤日志

(1) 过滤固定字符串

过滤固定字符串 : 只要命令行出现的日志都可以过滤, 不管是不是标签;

– 命令 : adb logcat | grep Wifi ;

过滤字符串忽略大小写 : adb logcat | grep -i wifi ;

(2) 使用正则表达式匹配

分析日志 : 该日志开头两个字符是 “V/”, 后面开始就是标签, 写一个正则表达式 “^..ActivityManager”, 就可以匹配日志中的 “V/ActivityManager” 字符串;

正则表达式过滤日志: 使用上面的正则表达式组成命令 adb logcat | grep “^..Activity” ;

apk相关:

1、安装apk（重要，记一下）

adb install 

adb install <apk文件路径>，将指定的apk安装到设备上，安装的apk包会放在/data/app目录下。

几个参数：  

-r 强制安装，

-d（真机，多个设备中只有一个真机时适用）

-e（模拟器，多个设备中只有一个模拟器时适用）

-s（指定设备，后接序列号）

adb –s 44a188f9 install –r test.apk（其中44a188f9即序列号，通过adb devices可获取）

adb install -r <apk文件路径>

-r 覆盖安装，保留数据和缓存文件

-d 解决低版本version问题

-s 安装apk到sd卡

如果见到类似如下输出（状态为 Success）代表安装成功：

12040 KB/s (22205609 bytes in 1.801s)

pkg: /data/local/tmp/SogouInput_android_v8.3_sweb.apk

Success

而如果状态为 Failure 则表示安装失败

2、卸载apk

adb uninstall 

adb uninstall -k < package_name >           # package_name为应用程序包名

可选参数-k的作用为卸载软件但是保留配置和缓存文件

3、查看app相关所有信息，包括action,codepath,version,需要的权限等等信息

adb shell dumpsys package <package_name>

4、查看app的路径

adb shell pm path <package_name>

查看了一个普通app的路径，如下，位于data/app下面的普通app

package:/data/app/com.tencent.test-1/base.apk

5、查看apk的版本信息

adb shell dumpsys package <package_name> | grep version

如果你得到的是下图的两个version版本，则为系统app,下面是系统app本身的版本，上面是升级之后的系统app的版本信息

6、启动activity

adb shell am start -n <package_name>/.<activity_class_name>

如何获取activity

自动化测试需要获得当前的activity，来判断处于的页面是否正确；

hierarchy view经常连不上真机，无法获得activity，所以直接用 adb命令来查看当前运行的 activity就可以；

方法一：

1、cmd命令中输入：adb shell 进入shell命令模式

2、shell中输入：   真机运行应用，可以实时 查看当前正在运行的Activity；

I/ActivityManager(  511): START u0 {act=Android.intent.action.INSERT dat=content

://com.example.notepad.provider.NotePad/notes cmp=com.example.android.notepad/.N

oteEditor} from pid 12896

cmp=com.example.android.notepad/.NoteEditor 中， 

com.example.android.notepad 是包名， NoteEditor是当前活动的activity；

方法二：

1.cmd命令中输入：adb shell dumpsys activity activities 

查看

  Main stack:

  * TaskRecord{42c4e888 #11 A com.example.android.notepad U 0}

    numActivities=2 rootWasReset=true userId=0

    affinity=com.example.android.notepad

    intent={act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER

] flg=0x10200000 cmp=com.example.android.notepad/.NotesList}

    realActivity=com.example.android.notepad/.NotesList

    askedCompatMode=false

    lastThumbnail=android.graphics.Bitmap@42c89cd8 lastDescription=null

    lastActiveTime=8685859 (inactive for 113s)

 cmp=com.example.android.notepad/.NotesList中， 

com.example.android.notepad 是包名， NotesList是当前活动的activity；

adb shell dumpsys activity | grep mFocusedActivity

运行后可以发现我的手机当前运行的activity是：

mFocusedActivity: ActivityRecord{42ddcd78 u0 com.android.mms/.ui.ConversationList t3}

ersationList.java界面，也就是短信息列表的界面。

7、获得应用的启动时间，可以很方便地获取应用的启动时间

adb shell am start -W <package_name>/.<activity_class_name>

实验结果如下：

返回的几个结果，以WaitTime为准，返回的是从startActivity到应用第一帧完全显示的时间。

8、启动service,am的-n参数表示组件，-a参数表示命令，-a后面的参数为manifest中定义的service的action

adb shell am startservice -n <package_name>/.<service_class_name>

也可：

adb shell am startservice -a "android.intent.action.CALL"

9、发送广播

adb shell am broadcast -a "android.intent.action.AdupsFota.WriteCommandReceiver"

广播可以带上不同类型的参数,--es为string参数类型,--ei为int参数类型,--ez为boolean参数类型

adb shell am broadcast -a "android.intent.action.AdupsFota.WriteCommandReceiver" --es test_string "this is test string"

10、查看某个app的进程相关信息

10.1

adb shell ps <package_name|PID>

小米手机上测试成功，在另外一个设备上，如果ps后面的参数是包名则显示不了进程的详细信息，参见下面的方式获取

10.2

adb shell ps | grep <package_name>

11、杀掉某个进程，一般用于模拟某个bug复现

adb shell kill pidNumber

12、查看某一个app的内存占用

adb shell dumpsys meminfo <package_name|PID>

结果如下，其中的Heap size包括了Dalvik Heap和Native Heap,平时我们所说的内存限制指的是Dalvik Heap。

13、查看单个应用程序的最大内存限制

adb shell getprop | grep heapgrowthlimit

得到的结果为128M: [dalvik.vm.heapgrowthlimit]: [128m]

这就是说Dalvik Heap size的最大值超过了128M，就很可能发生OOM

14、获取单个应用的电量消耗信息

Battery Historian是Android 5.0开始引入的，下面的命令为获取单个app的电量消耗信息，获取系统耗电信息见下节

adb shell dumpsys batterystats > <package_name> > xxx.txt

上面的电量信息为原始数据，可以通过google编写的historian.py脚本把数据信息转换为可读性很好的html文件,类似TraceView生成的列表数据，之前在做app性能优化的时候起了很大的作用

python historian.py xxx.txt > xxx.html

15、跑monkey,个人很喜欢这个命令，运行过程中，应用程序会不断切换画面，按照选定的不同级别反馈信息，还可以看到执行过程报告和生成的事件。测试应用的稳定性时很实用。 现在studio也有了monkeyrunner的tool

adb shell monkey -v -p <package_name> 500

 -p 对象包

 -v 反馈信息级别

16、查看应用程序的包名

列出手机装的所有app的包名：

adb shell pm list packages

使用 grep 来过滤：

adb shell “pm list packages | grep qq”

Monkey命令

一、什么是稳定性测试

通过随机点击屏幕一段时间，app不会出现崩溃、无响应等现象，能够正常维持运行的测试。

二、什么是monkey

Monkey是Android中的一个命令行工具，可以运行在模拟器里或实际设备中。它向系统发送伪随机的用户事件流(如按键输入、触摸屏输入、手势输入等)，实现对正在开发的应用程序进行压力测试。Monkey测试是一种为了测试软件的稳定性、健壮性的快速有效的方法。（工作原理）

1. monkey程序由android系统自带，使用Java语言写成，在Android文件系统中的存放路径是：/system/framework/monkey.jar

2.Monkey.jar程序是由一个名为“monkey”的Shell脚本来启动执行，shell脚本在Android文件系统中的存放路径是：/system/bin/monkey

3.Monkey测试是Android平台自动化测试的一种手段，通过Monkey程序模拟用户触摸屏幕、滑动Trackball、按键等操作来对设备上的程序进行测试，检测程序多久的时间会发生异常。     

4.官方介绍: https://developer.android.com/studio/test/monkey.html

5.Monkey 命令启动方式 

a. 可以通过PC机CMD窗口中执行: adb shell monkey ｛+命令参数｝来进行Monkey测试 

b. 在PC上adb shell 进入Android系统，通过执行monkey {+命令参数} 来进行Monkey 测试 

c. 在Android机或者模拟器上直接执行monkey 命令，可以在Android机上安装Android终端模拟器

三、Monkey特征

1、 测试的对象仅为应用程序包，有一定的局限性。

2、 Monky测试使用的事件流数据流是随机的，不能进行自定义。

3、 可对MonkeyTest的对象，事件数量，类型，频率等进行设置。

四、monkey 命令 以及说明

说明：

3.1 monkey 命令执行

adb shell monkey-p com.hst.che --throttle 500 -s 100 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -v -v -v 1000>D:androidmonkey_log16v3.txt 

3.2下面简单介绍下以上命令涉及到的各参数：

-s :

伪随机数生成器的 seed 值。如果用相同的 seed 值再次运行 Monkey ，它将生成相同的事件序列。

--throttle :

在事件之间插入固定延迟。通过这个选项可以减缓 Monkey 的执行速度。如果不指定该选项， Monkey 将不会被延迟，事件将尽可能快地被产成。

-p:

如果用此参数指定了一个或几个包，Monkey将只允许系统启动这些包里的Activity。 如果你的应用程序还需要访问其它包里的Activity(如选择取一个联系人)，那些包也需要在此 同时指定。如果不指定任何包，Monkey将允许系统启动全部包里的Activity。要指定多个 包，需要使用多个 -p选项，每个-p选项只能用于一个包。

查找包名的命令：adb shell pm list package -3

--kill-process-after-error:

通常，当Monkey由于一个错误而停止时，出错的应用程序将继续处于运行状态。当设置了此选项时，将会通知系 统停止发生错误的进程。注意，正常的(成功的)结束，并没有停止启动的进程，设备只是在结束事件之 后，简单地保持在最后的状态。

--ignore-timeouts:

通常，当应用程序发生任何超时错误(如“Application Not Responding”对 话框)时，Monkey将停止运行。如果设置此选项，Monkey将继 续向系统发送事件，直到计数完成。

--ignore-security-exceptions:

通常，当应用程序发生许可错误(如启动一个需要某些许可的Activity)时，Monkey将 停止运行。如果设置了此选项，Monkey将继续向系统发送事件，直到计数完成。

-v:

命令行的每一个 -v 将增加反馈信息的级别。 Level 0( 缺省值 ) 除启动提示、测试完成和最终结果之外，提供较少信息。 Level 1 提供较为详细的测试信息，如逐个发送到 ActivITy 的事件。 Level 2 提供更加详细的设置信息，如测试中被选中的或未被选中的 Activity 。下面的例子使用了"-v -v -v"，表示输出最详尽的monkey log。

例子：对小米商城APP跑monkey及其说明

adb shell monkey -p com.xiaomi.sc -v -v -v --throttle 200 -s 1 --ignore-crashes --ignore-timeouts --ignore-native-crashes --pct-touch 30 100000 2>/Users/admin/Desktop/error.txt 1>/Users/admin/Desktop/info.txt

1.$ adb shell monkey <event-count>                <event-count>是随机发送事件数

例：adb shell monkeyn 1000   发送1000个随机事件

2.$ adb shell monkey [options] <event-count>    [options]是monkey可传入的参数

 Monkey的option主要分为：常规类、事件类、约束类和调试类4种

2.1 常规类命令：

adb shell monkey -v <event-count>

-v:打印出日志信息，每个-v将增加反馈信息的级别。-v越多日志信息越详情，最多支持3个-v

2.2 事件类命令：

$ adb shell monkey -f <scriptfile> <event-count>

-f:后接测试脚本名，表示要使用monkey运行指定的monkey脚本，

如：$ adb shell monkey -f /mnt/sdcard/test01 3

注：这里的3是指循环次数，不是事件数

如果希望重复执行之前的随机操作，需要加-s命令，可指定随机数生成器seed值

$ adb shell monkey -s <seed> <event-count>

-s:后接随机数生成器的seed值，如果使用相同的seed值再次运行monkey,将生成相同的事件序列（也就是说，重复执行刚才的随机操作）

如： $ adb shell monkey -s 100 1000

$ adb shell monkey --throttle <milliseconds> 

--throttle:后面接时间，单位为ms,表示事件之间的固定延迟（即执行每一个指令间隔的时间），如果不接该项，monkey将不会延迟

$ adb shell monkey --pct-touch <percent>

--pct-touch:后面接触摸事件百分比，触摸事件泛指发生在某一位置的一个down-up事件，点击

$ adb shell monkey --pct-montion <percent>

--pct-motion:后面接动作事件百分比，动作事件泛指从某一位置接下（即down事件）后经过一系列伪随机事件后弹出（即up事件）

$ adb shell monkey --pct-trackball <percent>

--pct-trackball:后面接轨迹事件百分比，轨迹事件包括一系列的随机移动，以及偶尔跟随在移动后面的点击事件

$ adb shell monkey --pct-nav <percent>

--pct-nav:后面接基本导航事件百分比，基本导航事件主要来自方向输入设备的上、下、左、右事件

$ adb shell monkey --pct-majornav <percent>

--pct-marjornav:后面接主要导航事件百分比，主要导航事件通常指引发图形界面的一些动作，如键盘中间按键、返回按键、菜单按键

$ adb shell monkey --pct-syskeys <percent>

 --pct-syskeys:后面接系统按键事件百分比，系统按键事件通常指仅供系统使用的保留按键，如HOME键、BACK键、拨号键、挂断键、音量键等

$ adb shell monkey --pct-appswtich <percent>

 --pct-appswitch:后面接应用启动事件百分比，应用启动事件（activity launches)即打开应用，通过调用startActivity()方法最大限度地开启该package下的所有应用

$ adb shell monkey --pct-anyevent <percent>

--pct-anyevent:后面接其他类型事件百分比，其他类型事件指上文中未涉及的所有其他事件，如keypress、不常用的button等

2.3约束类命令

约束类命令可以让随机事件运行的范围限制在某几个包或类中。

$ adb shell monkey -p <allowed-package-name>  <event-count>

-p：后面接一个或多个包名,如果不指定任何包，monkey将允许系统启动全部包里的Activity。每个-p对应一个包，指定多个包时每个包名前都需要加上-p

如：$ adb shell monkey -p com.agent.tao  1000       运行com.agent.tao 包里的Activity并发送1000个随机事件

$ adb shell monkey -c <main-category>  <event-count>

-c:后面接一个或多个类别名，monkey将只允许系统启动这些类别中某个类别列出的Activity，如果不指定任何类别，monkey将选择Intent.CATEGORY_LAUNCHER和Intent.CATEGORY_monkey里的Activity

每个-c对应一个类别，指定多个类别时每个类别名前面都需要加上-c

如：$ adb shell monkey -c Intent.CATEGORY_LAUNCHER 1000

运行Inter.CATEGORY_LAUNCHER类别的Activity并发送1000个随机事件

2.4调试类命令

通过调试类命令可以对monkey进行简单的调试，这样可以快速定位monkey运行中的问题

$ adb shell monkey --dbg-no-events  <event-count>

--dbg-no-events：设置此项后，monkey将进行初始启动，进入到某个测试Activity中不会进一步生成事件，可以监视应用程序所调用的包之间的转换，为了更好的跟踪，一般该项

会与-v(日志）、-p<allowed-package-name> （包约束） 和 --throttle<milliseconds> (延迟）等联合使用

$ adb shell monkey --hprof  <event-count>

--hprof:设置此项后，将在monkey事件序列前后立即生成profilfing report，将在data/misc中生成5MB左右大小的文件

$ adb shell monkey --ignore-crashes  <event-count>

--ignore-crashes:设置此项后，当应用程序崩溃或发生失控异常时，monkey将继续运行直到计数完成。如果不设置此项，monkey遇到上述崩溃或异常将停止运行。

$ adb shell monkey --ignore-timeouts  <event-count>

--ignore-timeouts:设置此项后，当应用程序发生任何超时错误（如ANR，即Application Not Responding)时，monkey将继续运行直到计数完成。如果不设置此项，monkey

遇到此类超时将停止运行

$ adb shell monkey --kill-process-after-error  <event-count>

--kill-process-after-error:设置此项后，当monkey因为应用程序发生错误而停止时，将会通知系统停止发生错误的进程。如果不设置此项，monkey停止时发生错误的应用程度将

继续处于运行状态。

$ adb shell monkey --ignore-security-exceptions <event-count>

--ignore-security-exceptions：设置此项后，当应用程序发生任何权限错误（如启动一个需要某些权限的Activity)时，monkey将继续运行直到计数完成。如果不设置此项，

monkey遇到此类权限错误将停止运行。

$ adb shell monkey --monitor-native-crashes  <event-count>

--monitor-native-crashes:设置此项后，monkey运行时native code的崩溃事件将被监视并报告。如果不设置此选项，将不会监视此类事件。

$ adb shell monkey --wait-dbg  <event-count>

--wait-dbg:在设置此项后，将暂停执行中的monkey，直到有调试器与它连接。

五、monkey 报告组成：

1.第一部分：包含 seed值，执行次数、包名

2.第二部分：被测设备上的所有应用包名，本次测试使用到哪些包，未使用哪些包（建议测试某app时，杀掉其他应用进程）

第三部分：各个事件所占百分比，只显示了事件的代号，没有显示具体什么时间，可以查询monkey源代码中各代号对应的事件，所有事件包含：

 Event percentages本次测试的事件分布频率

* 0：触摸事件百分比，即参数–pct-touch 

*1：滑动事件百分比，即参数–pct-motion 

*2：缩放事件百分比，即参数–pct-pinchzoom 

*3：轨迹球事件百分比，即参数–pct-trackball 

*4：屏幕旋转事件百分比，即参数–pct-rotation 

*5：获取危险权限事件百分比，即参数–pct-permission//低版本没有

*6：基本导航事件百分比，即参数–pct-nav 

*7：主要导航事件百分比，即参数–pct-majornav 

*8：系统事件百分比，即参数–pct-syskeys 

*9：Activity启动事件百分比，即参数–pct-appswitch 

*10：键盘翻转事件百分比，即参数–pct-flip 

*11：其他事件百分比，即参数–pct-anyevent

--pct-touch ｛+百分比｝

调整触摸事件的百分比(触摸事件是一个down-up事件，它发生在屏幕上的某单一位置)

adb shell monkey -p com.htc.Weather--pct-touch 10 1000

--pct-motion ｛+百分比｝

调整动作事件的百分比(动作事件由屏幕上某处的一个down事件、一系列的伪随机事件和一个up事件组成)adb shell monkey -p com.htc.Weather --pct-motion 20 1000

--pct-trackball ｛+百分比｝

调整轨迹事件的百分比(轨迹事件由一个或几个随机的移动组成，有时还伴随有点击)

adb shell monkey -p com.htc.Weather--pct-trackball 30 1000

--pct-nav ｛+百分比｝

调整“基本”导航事件的百分比(导航事件由来自方向输入设备的up/down/left/right组成)

--pct-majornav ｛+百分比｝

调整“主要”导航事件的百分比(这些导航事件通常引发图形界面中的动作，如：5-way键盘的中间按键、回退按键、菜单按键)

adb shell monkey -p com.htc.Weather--pct-majornav 50 1000

--pct-syskeys ｛+百分比｝

调整“系统”按键事件的百分比(这些按键通常被保留，由系统使用，如Home、Back、Start Call、End Call及音量控制键)

adb shell monkey -p com.htc.Weather--pct-syskeys 60 1000

--pct-appswitch ｛+百分比｝

调整启动Activity的百分比。在随机间隔里，Monkey将执行一个startActivity()调用，作为最大程度覆盖包中全部Activity的一种方法

adb shell monkey -p com.htc.Weather--pct-appswitch 70 1000

 --pct-anyevent ｛+百分比｝

调整其它类型事件的百分比。它包罗了所有其它类型的事件，如：按键、其它不常用的设备按钮、等等

 --pct -anyevent  ｛+百分比｝

指定多个事件的百分比

adb shell monkey -p com.htc.Weather--pct-anyevent 50 --pct-appswitch 50 1000

注意：各事件类型的百分比总数不能超过100%； Bottom of Form

第四部分：具体事件

第五部分：log 完成

如果Monkey测试顺利执行完成，在log的最后，会打印出当前执行事件的次数和所花费的时间；// Monkey finished代表执行完成。

如果Monkey执行中断，在log的最后也能查看到当前已执行的次数。Monkey执行完成的log具体如下：

Events injected: 6000

:Dropped: keys=0 pointers=9 trackballs=0 flips=0

## Network stats: elapsed time=808384ms (0ms mobile, 808384ms wifi, 0msnot connected)

// Monkey finished

六、分析报告：

测试结束后，需要将手机连接PC，拷贝以下文件：

info.txt：此文件在手机上的SDCARD中，主要记录了MONKEY测试时发送的各种事件，如触摸事件的位置等等。

error.txt：此文件在手机上的SDCARD中，主要记录了MONKEY测试时产生的一些ANR、强制关闭等异常。

LOG文件：此文件在手机上的LOG文件夹中中，主要主要记录程序对MONKEY测试时的响应情况。

1.在日志中搜索关键字：

1）搜索报告中的关键字“ANR”，看有无应用无响应的事件（Application Not Responding）

2）搜索报告中的关键字“crash”,看有无崩溃的事件

3）搜索报告中的关键字“exception”，看有无其他异常事件。（如果出现空指针， NullPointerException，需格外重视

下面的属于monkey自己的问题。不用管。

:Sending Flip keyboardOpen=false

Got IOException performing flipjava.io.IOException: write failed: EINVAL (Invalid argument)

// Injection Failed

4）内存泄露问题搜索"GC"（需进一步分析）

2. 初步分析法： monkey出现错误后，一般的分析步骤

1）先找到出现错误的位置

2）查看出现错误之前2个switch之间的activity

3）手动执行事件，复现问题

4）若以上步骤还不能找出，产生错误时，有会seed值，输入相同的seed值，重新按照之前命令跑monkey

3.详细分析法：

1） ANR问题：在日志中搜索“ANR”(“Application Not Responding")，说明有bug，出现ANR，一般是主线程的响应超过5秒，或者BroadcastReceiver没有在10秒内作出响应。这个就是一个比较严重的缺陷。把耗时的操作另起线程来处理就可以了。

2）分析log中的具体信息：

查看log中第一个Switch，主要是查看Monkey执行的是那一个Activity，譬如下面的log中，执行的是com.tencent.smtt.SplashActivity，在下一个swtich之间的，如果出现了崩溃或其他异常，可以在该Activity中查找问题的所在。

:Switch:#Intent;action=android.intent.action.MAIN;category=android.intent.category.LAUNCHER;launchFlags=0x10000000;component=com.tencent.smtt/.SplashActivity;end

//Allowing start of Intent {act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER]cmp=com.tencent.smtt/.SplashActivity } in package com.tencent.smtt

3)内存泄漏

1. 内存泄漏弹出out of memory对话框

2. 对于有内存泄漏但是没有单出out of memory对话框的情况，可以通过logcat文件GC出信息，(GC:java的垃圾回收机制)

GC_FOR_ALLOC: 因为在分配内存时候内存不够引起的

GC_EXPLICIT： 表明GC被显式请求触发的，如System.gc调用，

GC_CONCCURRENT: 表明GC在内存使用率达到一定的警戒值时候，自动触发

GC_BEFORE_OOM： 表明在虚拟机抛出内存不够异常oom之前，执行最后一次回收内存垃圾

2.发现内存泄露--内存报告分析（利用hprof参数的内存快照生成内存报告）

在发现内存泄露后，可以执行相同的monkey，只需多加一个参数--hprof 

adb shell monkey -p 包名  --hprof --throttle 100  --pct-touch 50 --pct-motion 50 -v -v -v 1000 >c:monkey.txt

如果指定了这个选项，monkey会在发送时间的前后生成ａｐｐ内存快照文件，一般会在手机设备的/data/misc目录下生成hprof的文件。（注：  /data/misc  需要root权限，可

以在手机上安装个RE查看或通过手机助手查看）

ps：文件转换：配置monkey测试时的sdk-tools下查看是否hprof-conv命令，在命令行输入hprof-conv -help得知文件转化用法，直接转化就行，由.hprof转化成.conv格式。

转化后的文件用eclipse的Memory Analyzer tool(MAT)查看（此插件可以下载），可以点击 Reports->Leak Suspects链接来生成报告。