Android ADB 命令总结 - 浅笑未来

时间:2024-04-17 08:02:06

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:\sdk\Android_SDK_windows\sdk\platform-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.****.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:\android\monkey_log\16v3.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会在发送时间的前后生成app内存快照文件,一般会在手机设备的/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链接来生成报告。