感谢团队同事的辛勤劳动和付出。
------此处献上我的膝盖
----------------------------------------------华丽分割线-------------------------------------------
原理:
ADB是一个C/S架构的应用程序,由三部分组成:
adb client向ADB servcer发送服务请求。
作用: (1)检测USB端口感知设备的连接/拔除和模拟器实例的启动或停止; (2)监听adb client的请求并发送到对应的adbd上。
作用: 连接ADB服务器,并且为运行在主机上的客户端提供一些服务。 基本用法 1.设备连接 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
查看应用列表 | 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>] |
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 | 省电模式开启 |
启动的方法:adb shell am start -n包名/启动页的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] 组成。
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 日志)。
可以用 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重定向到文件中
查看设备型号信息 | 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 |
注: 修改设置之后,运行恢复命令有可能显示仍然不太正常,可以运行 #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端应用和手机端应用的数据传递。
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 //退出数据库