感谢团队同事的辛勤劳动和付出。
------此处献上我的膝盖
----------------------------------------------华丽分割线-------------------------------------------
原理：
ADB是一个C/S架构的应用程序，由三部分组成：
- adb client --运行在pc端 运行adb命令：尝试定位ADB服务器，找不到则启动一个服务器；
adb client向ADB servcer发送服务请求。
- adb server--运行在pc端的后台进程
作用： （1）检测USB端口感知设备的连接/拔除和模拟器实例的启动或停止； （2）监听adb client的请求并发送到对应的adbd上。
- adb demon (adbd) --运行在设备端、常驻进程
作用: 连接ADB服务器，并且为运行在主机上的客户端提供一些服务。 基本用法 1.设备连接 USB连接：
- Android设备正常开机，通过USB线与电脑连接
- 开启开发者选项和USB调试模式
- 设备驱动状态正常
无线连接（需借助usb）： 1.将 Android 设备通过USB与电脑相连，且两者连到同一个局域网 2. 让设备在 5555 端口监听 TCP/IP 连接：adb tcpip 5555 4. 断开 USB 连接。 5. 通过设备IP地址连接设备。adb connect <device-ip-address> （断开无线连接adb disconnect <device-ip-address>） 2.基本命令
| 命令 |
含义 |
| adb verion |
查看adb版本 |
| adb start-server |
启动adb server(一般无需手动启动) |
| adb kill-server |
停止adb server |
| adb root |
以 root 权限运行 adbd |
| adb unroot |
以 普通权限运行 adbd |
| adb remount |
已读写方式挂载系分区/system |
| adb devices |
查询已经链接的设备 |
| adb get-serialno |
打印设备序列号（和adb devices中的序列号一致） |
| adb wait-for-device |
阻塞直到设备在线 |
| adb get-state |
查看设备状态： device：设备正常连接 offline：连接出现异常，设备无响应 unknown：没有连接设备 |
| adb status-window |
连续输出设备状态 |
| adb bugreport |
返回设备bug report相关的所有信息 |
| adb [-d|-e|-s ] |
adb -e shell //进入到模拟器中 adb –d shell //进入到真机中 adb –s <设备id> shell //进入到指定设备中 |
| adb shell svc wifi enable/disable |
开/关wifi |
| adb reboot |
重启设备 |
| adb reboot-bootloader |
设备重启到bootloader模式 |
| adb reboot [bootloader|recovery] |
设备重启到bootloader或recovery模式 |
| adb tcpip <port> |
重启adbd在指定的tcp端口上进行监听 |
| adb usb |
重启adbd在usb上进行监听 |
实用功能：
- 截图
adb shell screencap –h查看参数 adb exec-out screencap -p > sc.png //直接保存到本地电脑 或 adb shell screencap -p /sdcard/sc.png //保存到手机 adb pull /sdcard/sc.png
- 录制屏幕
adb shell screenrecord --help看详细参数 adb shell screenrecord /sdcard/filename.mp4 需要停止时按Ctr+C，默认录制时间和最长录制时间为180s。
- 获取当前界面的控件信息
adb shell uiautomator dump [--compressed] [file] dump出当前窗口的UI布局简化信息到指定文件，默认文件是在/sdcard/window_dump.xml
- 应用管理
1.应用查看/安装/卸载
| 查看应用列表 |
adb shell pm list packages [-f] [-d] [-e] [-s] [-3] [-i] [-u] [--user USER_ID] [FILTER] |
| 参数 |
显示列表 |
| 无 |
所有应用 |
| -f |
显示应用关联的 apk 文件 |
| -d |
只显示 disabled 的应用 |
| -e |
只显示 enabled 的应用 |
| -s |
只显示系统应用 |
| -3 |
只显示第三方应用 |
| -i |
显示应用的 installer |
| -u |
包含已卸载应用 |
| <FILTER> |
包名包含 <FILTER> 字符串 |
| 查看应用详细信息 |
adb shell dumpsys package <packagename> |
| 安装apk |
adb install [-lrtsdg] <path_to_apk> |
| -l |
将应用安装到保护目录 /mnt/asec |
| -r |
允许覆盖安装 |
| -t |
允许安装 AndroidManifest.xml 里 application 指定 android:testOnly="true" 的应用 |
| -s |
将应用安装到 sdcard |
| -d |
允许降级覆盖安装 |
| -g |
授予所有运行时权限 |
| 卸载应用 |
adb uninstall [-k] <packagename> -k 卸载应用但保留数据和缓存目录 |
| 查看安装路径 |
adb shell pm path <packagename> |
| 清除应用数据及缓存 |
adb shell pm clear <packagename> |
| 查看前台activity |
adb shell dumpsys activity activities | findstr mFocusedActivity 或adb shell dumpsys activity | grep -i run 或adb shell dumpsys activity activities | sed -En -e ‘/Running activities/,/Run #0/p‘ |
| 查看正在运行的Services |
adb shell dumpsys activity services [<packagename>] |
2.与应用的交互
adb shell am <command>
| 命令 |
用途 |
| am start [options] <INTENT> |
启动 <INTENT> 指定的 Activity |
| am startservice [options] <INTENT> |
启动 <INTENT> 指定的 Service |
| am broadcast [options] <INTENT> |
发送 <INTENT> 指定的广播 |
| am force-stop <packagename> |
停止 <packagename> 相关的进程 |
[options]选项如下：
| 参数 |
含义 |
| -a <ACTION> |
指定 action，比如 android.intent.action.VIEW |
| -c <CATEGORY> |
指定 category，比如 android.intent.category.APP_CONTACTS |
| -n <COMPONENT> |
指定完整 component 名，用于明确指定启动哪个 Activity，如 com.example.app/.ExampleActivity |
例如： 1）adb shell am start -n com.
tencent.mm/.ui.LauncherUI //表示调起微信主界面 2）adb shell am startservice -n
com.tencent.mm/.plugin.account.model.AccountAuthenticatorService //表示调起微信的某个 Service. 3）adb shell am broadcast -a android.intent.action.BOOT_COMPLETED -n org.mazhuang.boottimemeasure/.BootCompletedReceiver //只向BootCompletedReceiver发送广播BOOT_COMPLETED 4）adb shell am force-stop com.qihoo360.mobilesafe //停止 360 安全卫士
| 部分系统预定义广播及正常触发时机 |
| action |
触发时机 |
| android.net.conn.CONNECTIVITY_CHANGE |
网络连接发生变化 |
| android.intent.action.SCREEN_ON |
屏幕点亮 |
| android.intent.action.SCREEN_OFF |
屏幕熄灭 |
| android.intent.action.BATTERY_LOW |
电量低，会弹出电量低提示框 |
| android.intent.action.BATTERY_OKAY |
电量恢复了 |
| android.intent.action.BOOT_COMPLETED |
设备启动完毕 |
| android.intent.action.DEVICE_STORAGE_LOW |
存储空间过低 |
| android.intent.action.DEVICE_STORAGE_OK |
存储空间恢复 |
| android.intent.action.PACKAGE_ADDED |
安装了新的应用 |
| android.net.wifi.STATE_CHANGE |
WiFi连接到一个ssid后的广播 |
| android.net.wifi.WIFI_STATE_CHANGED |
WiFi 状态变为启用/关闭/正在启动/正在关闭/未知 |
| android.intent.action.BATTERY_CHANGED |
电池电量发生变化 |
| android.intent.action.INPUT_METHOD_CHANGED |
系统输入法发生变化 |
| android.intent.action.ACTION_POWER_CONNECTED |
外部电源连接 |
| android.intent.action.ACTION_POWER_DISCONNECTED |
外部电源断开连接 |
| android.intent.action.DREAMING_STARTED |
系统开始休眠 |
| android.intent.action.DREAMING_STOPPED |
系统停止休眠 |
| android.intent.action.WALLPAPER_CHANGED |
壁纸发生变化 |
| android.intent.action.HEADSET_PLUG |
插入耳机 |
| android.intent.action.MEDIA_UNMOUNTED |
卸载外部介质 |
| android.intent.action.MEDIA_MOUNTED |
挂载外部介质 |
| android.os.action.POWER_SAVE_MODE_CHANGED |
省电模式开启 |
3.如何启动被测程序？
启动的方法：adb shell am start -n包名/启动页的Activity
- 确定包名：adb shell pm list package -f
- 查看app启动页Activity：
adb shell dumpsys package <包名> 找到包含“category.LAUNCHER”的Activity即为启动页Activity
- 文件管理
adb pull <设备里的文件路径> [电脑上的目录] //复制设备里的文件到电脑 adb push <电脑上的文件路径> <设备里的目录> //复制电脑里的文件到设备
- 模拟按键/输入
input [<source>] <command> [<arg>...] (详情见adb shell input --help) 屏幕点击：adb shell input tap <x> <y> //在屏幕上点击坐标点(x,y)的位置 屏幕滑动：adb shell input swipe <x1> <y1> <x2> <y2> //从(x1,y1)滑动到（x2,y2） 文本输入：adb shell input text <string> //将<string>输入到文本框中 模拟按键： adb shell input keyevent <keycode>
| keycode |
含义 |
keycode |
含义 |
| 3 |
HOME 键 |
126 |
恢复播放 |
| 4 |
返回键 |
127 |
暂停播放 |
| 5 |
打开拨号应用 |
164 |
静音 |
| 6 |
挂断电话 |
176 |
打开系统设置 |
| 24 |
增加音量 |
187 |
切换应用 |
| 25 |
降低音量 |
207 |
打开联系人 |
| 26 |
电源键 |
208 |
打开日历 |
| 27 |
拍照（需要在相机应用里） |
209 |
打开音乐 |
| 64 |
打开浏览器 |
210 |
打开计算器 |
| 82 |
菜单键 |
220 |
降低屏幕亮度 |
| 85 |
播放/暂停 |
221 |
提高屏幕亮度 |
| 86 |
停止播放 |
223 |
系统休眠 |
| 87 |
播放下一首 |
224 |
点亮屏幕 |
| 88 |
播放上一首 |
231 |
打开语音助手 |
| 122 |
移动光标到行首或列表顶部 |
276 |
如果没有 wakelock 则让系统休眠 |
| 123 |
移动光标到行末或列表底部 |
|
|
- 日志
Android 系统的日志分为两部分，底层的 Linux 内核日志输出到/proc/kmsg，Android 的日志输出到 /dev/log。 Android 日志命令格式： [adb] logcat [<option>] ... [<filter-spec>] ... 其中<filter-spec> 可以由多个 <tag>[:priority] 组成。
1.日志过滤
Android 的日志分为如下几个优先级（priority）： V —— Verbose（最低，输出得最多） D —— Debug I —— Info W —— Warning E —— Error F —— Fatal S —— Silent（最高，啥也不输出） 按某级别过滤日志则会将该级别及以上的日志输出。 比如： adb logcat ActivityManager:I MyApp:D *:S //输出 tag ActivityManager 的 Info 以上级别日志，输出 tag MyApp 的 Debug 以上级别日志，及其它 tag 的 Silent 级别日志（即屏蔽其它 tag 日志）。
2.日志格式:
可以用 adb logcat -v <format> 选项指定日志输出格式。
| <format>格式名称 |
输出格式 |
输出举例 |
| brief（默认格式） |
<priority>/<tag>(<pid>): <message> |
D/HeadsetStateMachine( 1785): Disconnected process message: 10, size: 0 |
| process |
<priority>(<pid>) <message> |
D( 1785) Disconnected process message: 10, size: 0 (HeadsetStateMachine) |
| tag |
<priority>/<tag>: <message> |
D/HeadsetStateMachine: Disconnected process message: 10, size: 0 |
| raw |
<message> |
Disconnected process message: 10, size: 0 |
| time |
<datetime> <priority>/<tag>(<pid>): <message> |
08-28 22:39:39.974 D/HeadsetStateMachine( 1785): Disconnected process message: 10, size: 0 |
| threadtime |
<datetime> <pid> <tid> <priority> <tag>: <message> |
08-28 22:39:39.974 1785 1832 D HeadsetStateMachine: Disconnected process message: 10, size: 0 |
| long |
[ <datetime> <pid>:<tid> <priority>/<tag> ] <message> |
[ 08-28 22:39:39.974 1785: 1832 D/HeadsetStateMachine ] Disconnected process message: 10, size: 0 |
adb logcat -v <format> > <文件名> //将log重定向到文件中
3. 清空日志：adb logcat -c
4. 内核日志命令：adb shell dmesg
- 查看/修改设备信息
1.查看设备信息
| 查看设备型号信息 |
adb shell getprop ro.product.model |
| 查看电池状况 |
adb shell dumpsys battery |
| 屏幕分辨率 |
adb shell wm size |
| 设备屏幕密度 |
adb shell wm density |
| 显示屏参数命令 |
adb shell dumpsys window displays |
| android_id |
adb shell settings get secure android_id |
| IMEI |
Android 4.4 及以下版本：adb shell dumpsys iphonesubinfo 在 Android 5.0 及以上版本(要root权限)： #adb shell su service call iphonesubinfo 1 |
| Android 系统版本 |
adb shell getprop ro.build.version.release |
| IP地址 |
adb shell ifconfig | grep Mask 或 adb shell netcfg (部分系统版本可以) 或 设备连着 WiFi时可尝试：adb shell ifconfig wlan0 |
| Mac 地址 |
adb shell cat /sys/class/net/wlan0/address(局域网 Mac 地址) 移动网络或其它连接的信息可用adb shell netcfg 命令来查看 |
| CPU 信息 |
adb shell cat /proc/cpuinfo |
| 内存信息 |
adb shell cat /proc/meminfo |
| 更多硬件与系统属性 |
adb shell cat /system/build.prop |
2.修改设备信息
注： 修改设置之后，运行恢复命令有可能显示仍然不太正常，可以运行 #adb reboot 重启设备，或手动重启。 修改设置的原理主要是通过settings 命令修改/data/data/com.android.providers.settings/databases/settings.db(Android6.0后为/data/system/users/userid/下面的xml文件) 里存放的设置值。
| 修改/恢复分辨率 |
adb shell wm size 480x1024 adb shell wm size reset |
| 修改/恢复屏幕密度 |
adb shell wm density 160 adb shell wm density reset |
| 修改/恢复显示区域命令： |
adb shell wm overscan 0,0,0,200（四个数字分别表示距离左、上、右、下边缘的留白像素，以上命令表示将屏幕底部 200px 留白。） adb shell wm overscan reset |
| 关闭 USB 调试模式 |
adb shell settings put global adb_enabled 0 |
| 状态栏和导航栏的显示隐藏 |
adb shell settings put global policy_control <key1>=<value1>:<key2>=<value2>… |
| 状态栏和导航栏的显示隐藏： adb shell settings put global policy_control <key1>=<value1>:<key2>=<value2>… |
| Key |
Value |
| immersive.full同时隐藏 |
apps所有应用 |
| immersive.status 隐藏状态栏 |
* 所有界面 |
| immersive.navigaion 隐藏导航栏 |
packagename指定应用 |
| immersive.precomfirms ？ |
-packagename排除指定应用 |
例如： #adb shell settings put global policy_control immersive.full=* 表示设置在所有界面下都同时隐藏状态栏和导航栏。 # adb shell settings put global policy_control immersive.full=-* //取消上面的隐藏 #adb shell settings put global policy_control immersive.status=com.package1,com.package2:immersive.navigation=apps,-com.package3 表示设置在包名为com.package1 和com.package2 的应用里隐藏状态栏，在除了包名为com.package3 的所有应用里隐藏导航栏。
- 备份与还原
备份：adb backup [-f <file>] [-apk|-noapk] [-obb|-noobb] [-shared|-noshared] [-all] [-system|-nosystem] [<packages...>] 还原：adb restore <file>
| 备份选项 |
含义 |
| adb backup -all |
使用默认方式备份应用和设备的数据（不包含apk）到当前目录下并保存为文件backup.ab |
| -f |
指定备份文件 |
| -obb|-noobb |
备份是否包含程序连带的扩展数据，默认是-noobb |
| -apk|-noapk |
备份中是否包含apk |
| -shared|-noshared |
是否备份设备共享的SD card内容 |
| -system|-nosystem |
决定-all是否包含系统应用，默认的是-system |
| [<packages...>] |
带包名表示只备份此包的相关信息 |
例如：adb backup -apk -shared -system -all -f backup_apk.ab
- 转发
adb forward [--no--rebind] <local> <remote> adb forward --remove <local> adb forward --remove-all adb forward --list 例如：adb forward tcp:11111 tcp:22222 建立一个转发将PC端的11111端口收到的数据，转发给到手机中22222端口。但是只执行这个命令还不能转发数据，还需要完成两个步骤才能传数据。这两个步骤是： （a）在手机端，建立一个端口为22222的server，并打开server到监听状态。 （b）在PC端，建立一个socket client端，连接到端口为11111的server上。 PC端的应用与手机端应用之间传输数据的过程： （1）PC端应用将数据发送给端口为11111的server（adb创建的） （2）adb将数据转发给手机端adbd进程（通过USB传输） （3）adbd进程将数据发送给端口为22222的server（手机端应用创建的） 传递是双向的，第（1）和第（3）步是通过socket实现的，所以通过socket的读和写就完成了PC端应用和手机端应用的数据传递。
- Mokey测试
Monkey程序由Android系统自带，使用Java语言写成，在Android文件系统中的存放路径是：/system/framework/monkey.jar； Monkey.jar程序是由一个名为“monkey”的Shell脚本来启动执行，shell脚本在Android文件系统中的存放路径是：/system/bin/monkey； 帮助文档：adb shell monkey --help 参数介绍：
| Monkey命令参数 |
含义 |
| -p |
参数指定一个或多个包。 adb shell monkey -p com.htc.Weather –p com.htc.pdfreader 100 |
| -v |
指定日志的详细程度，总共分3个级别： Level 0：缺省值，提供启动提示、测试完成和最终结果等少量信息。 adb shell monkey -p com.htc.Weather –v 100 Level 1：详细的日志，包括每个发送到Activity的事件信息 adb shell monkey -p com.htc.Weather -v -v 100 Level 2：最详细的日志，包括了测试中选中/未选中的Activity信息 adb shell monkey -p com.htc.Weather -v -v -v 100 |
| -s |
指定伪随机数生成器的seed值 adb shell monkey -p com.htc.Weather -s 10 100 |
| --throttle <毫秒> |
指定用户操作（即事件）间的时延。 adb shell monkey -p com.htc.Weather –throttle 3000 100 |
| --ignore-crashes |
程序崩溃仍发送事件，直到事件计数完成。 adb shellmonkey -p com.htc.Weather --ignore-crashes 100 |
| --ignore-timeouts |
程序发生ANR时，仍然发送事件，直到事件计数完成。 |
| --ignore-security-exceptions |
当应用程序发生许可错误时（如证书许可，网络许可等），仍然发送事件，直到事件计数完成。 |
| --kill-process-after-error |
当应用程序发生错误时，停止运行并保持在当前状态，（应用程序仅是静止在发生错误时的状态，系统并不会结束该应用程序的进程） |
| --monitor-native-crashes |
用于指定是否监视并报告应用程序发生崩溃的本地代码。 |
| --pct-｛+事件类别｝｛+事件类别百分比｝ |
用于指定每种类别事件的数目百分比（在Monkey事件序列中，该类事件数目占总事件数目的百分比） adb shell monkey –p <pkg> --pct-touch 10 1000 |
| 事件类别 |
含义 |
| --pct-touch |
触摸事件：是一个down-up事件，它发生在屏幕上的某单一位置 |
| --pct-motion |
动作事件：由屏幕上某处的一个down事件、一系列的伪随机事件和一个up事件组成 |
| --pct-trackball |
轨迹事件：由一个或几个随机的移动组成，有时还伴随有点击 |
| --pct-nav |
基本导航事件：由来自方向输入设备的up/down/left/right组成 |
| --pct-majornav |
主要导航事件：此类事件通常引发图形界面中的动作，如：5-way键盘的中间按键、回退按键、菜单按键 |
| --pct-syskeys |
系统按键：Home、Back、Start Call、End Call及音量控制键等 |
| --pct-appswitch |
调整启动Activity的百分比。在随机间隔里，Monkey将执行一个startActivity()调用，作为最大程度覆盖包中全部Activity的一种方法 |
| --pct-anyevent |
调整其它类型事件的百分比。它包罗了所有其它类型的事件，如：按键、其它不常用的设备按钮、等等 |
- 数据库操作
adb shell sqlite3 <数据库文件> //进入到数据库中 sqlite>.tables //列出各个表 sqlite>.schema <表名> //获得完整的数据库表字段信息 sqlite>.help //查看命令 sqlite> select * from <表名> //SQL语句 sqlite> .exit //退出数据库
