adb 全称为 Android Debug Bridge(Android 调试桥),是 Android SDK 中提供的用于管理 Android 模拟器或真机的工具。
adb 是一种功能强大的命令行工具,可让 PC 端与 Android 设备进行通信。adb 命令可执行各种设备操作,例如安装和调试应用。
adb组成
chuo >>> qrcode.ceba.ceshiren.com/link?name=a…
采用了客户端-服务器(C/S)模型,包括三个部分:
- adb Client:运行在电脑上,可以在命令行中运行 adb 命令来调用该客户端。Client 本质上就是 Shell,用来发送命令给 Server。发送命令时,首先检测 PC 上有没有启动 Server,如果没有 Server,则会自动启动一个,然后将命令发送到 Server。
- adb Server:运行在电脑上的后台进程,用于管理客户端与运行在模拟器或真机的守护进程通信。
- adb Daemon:守护进程作为一个后台进程在 Android 设备或模拟器系统中运行。它的作用是连接 adb 服务端,并且为运行在主机上的 adb 客户端提供一些服务。
adb工作原理
当 adb 客户端启动时,客户端会先检查 adb 服务端是否启动。如果没有,会先启动服务端进程。adb 服务端在启动后,会与 5037 端口绑定,并监听 adb 客户端发出的命令。
然后服务端会与所有正在运行的 Android 设备建立连接。它通过扫描 5555 到 5585 之间的奇数号端口查找 Android 设备。服务端一旦发现 Android 设备上的 adb 守护进程在运行,便会与相应的端口建立连接。每个 Android 设备都使用一对端口,偶数端口用于控制台连接,奇数端口用于 adb 连接。
服务端与所有 Android 设备建立连接后,就可以使用 adb 命令来访问这些设备了。服务端会管理已经建立的连接,并处理来自 adb 客户端的命令。
chuo >>> qrcode.ceba.ceshiren.com/link?name=a…
启动adb调试
Android 真机可以通过 USB 连接到 adb,连接时需要在设备的系统设置中启用 USB 调试(位于开发者选项下),启动 USB 调试后,设备上的 adb 守护进程就会被启动,adb 服务端才可以和设备建立连接。除了用 USB 的方式连接之外,也可以通过 WLAN 的方式连接,这种方式不做赘述。
- 模拟器:不需要手动设置 USB 调试开关,默认是打开的
- 真机通过 USB 连接
- 安装 Android 手机驱动
- 设备启用 USB 调试
adb常用命令
adb 命令格式
adb [-d|-e|-s <serialNumber>] <command>
- -d:指定当前唯一通过 USB 连接的 Android 设备为命令目标
- -e:指定当前唯一运行的模拟器为命令目标
- -s:指定相应 serialNumber 号的设备/模拟器为命令目标
方括号中的内容是可选的,尖括号内容的是必填的。方括号中参数可以指定设备,关于设备的指定有三个参数可以使用。-d、-e 和 -s,其中使用最多的是 -s 参数,在连接多台设备的时候,一般都是使用 -s 加上设备的序列号这种方式去指定具体设备。
adb 可以同时连接多台设备,但是一次只能对一台设备执行命令。所有连接多台设备的时候,是必须要制定设备,命令才可以执行成功的。
查询设备
把 Android 设备连接到 adb 服务端后,需要确认设备的连接状态。这时可以使用查询命令进行查询。
连接模拟器(以 MUMU 模拟器为例)
adb connect 127.0.0.1:7555
adb devices
adb connect命令可以通过 WLAN 的方式连接到模拟器,7555 为 mumu 模拟器的端口adb devices可以查询设备连接的状态
Windows 系统中,连接模拟器需要先执行 connect 命令去连接模拟器,127.0.0.1 是本地的 IP 地址,因为模拟器就是安装在本地的,所以要使用本地的 IP 地址,加上模拟器本身规定的一个端口号。mumu 的端口号是 7555,如果使用的是其他的模拟器的话,需要先去了解它的端口号是什么,然后再去连接。MacOS 系统中连接模拟器不需要先执行 connect 命令,直接执行 adb kill-server && adb devices 命令即可。
连接真机
真机直接用 USB 连接到电脑,不需要执行 connect 命令。
chuo >>> qrcode.ceba.ceshiren.com/link?name=a…
直接用 adb devices 命令查看已经连接的设备列表即可。
hogwarts@ ~ % adb devices
List of devices attached
emulator-5554 device
直接命令后,如果设备已经成功连接,那么设备列表中就会展示已连接设备的信息。
- emualotr-5554:设备序列号
- device:设备连接状态为成功
安装卸载应用
测试过程中,如果需要安装或者卸载应用,可以直接用 adb 命令来操作。
- 普通安装:
adb install <apk路径> - 覆盖安装:
adb install -r <apk路径> - 完全卸载:
adb uninstall <包名> - 保留配置文件:
adb uninstall -k <包名>
设备与电脑传输文件
adb 命令支持电脑和 Android 设备之间的文件互传。比如要提取 Android 设备中的日志文件到本地,就可以通过 adb 命令的方式来完成。
- 从电脑上传文件至设备:
adb push <电脑路径> <设备路径> - 从设备复制文件至电脑:
adb pull <设备路径> <电脑路径>
日志
打印链接设备的 log 信息
- 屏幕输出日志:
adb logcat - 通过标签过滤:
adb logcat -s 标签 - 显示时间:
adb logcat -v time - 输出所有信息:
adb logcat -v long - 输出日志到文件:
adb logcat -v time > log.txt - 清除缓存日志信息:
adb logcat -c
adb shell 命令
使用 adb shell 命令相当于远程登录了 Android 系统,可以进入 Android 设备的系统内部。进入系统内部既可以执行一些简单的 Linux 命令也支持很多特有的命令。
使用 adb shell 命令有两种方式。
一种是直接在 adb shell 后面跟上命令。
adb [-s serial_number] shell <command>
比如:
hogwarts@ ~ % adb shell ls
acct
cache
charger
config
d
data
default.prop
dev
etc
...
另一种方式是在设备上启动交互式 shell
adb [-s serial_number] shell
进入 shell 之后,再执行对应的命令。
比如进入设备内部,可以查看设备内部的目录结构和内容
hogwarts@ ~ % adb shell
root@x86:/ # ls
acct
cache
charger
config
d
data
default.prop
dev
...
chuo >>> qrcode.ceba.ceshiren.com/link?name=a…
要退出交互式 shell,可以按 Ctrl + D 键或输入 exit。
Andriod常用测试命令
设备截图 / 录屏
在测试过程中,如果需要截图或者是录屏,也可以直接使用 adb 命令来完成。
- 截图:
adb shell screencap <设备路径> - 录屏:
adb shell screenrecord <设备路径>
调用 Activity 管理器
在 adb shell 中,可以使用 Activity 管理器 (am) 工具发出命令以执行各种系统操作,如启动 Activity、强行停止进程、修改设备屏幕属性,等等。
在测试过程中,如果需要启动 app 或者强制关闭 app,可以通过 adb 命令来实现。
- 启动应用:
adb shell am start -n <包名>/<Activity名> - 强制停止应用:
adb shell am force-stop <包名>
调用软件包管理器
在 adb shell 中,可以使用软件包管理器 (pm) 工具发出命令,以对设备上安装的应用软件包执行操作和查询。
如果需要查询设备里都安装了什么应用,就可以使用 adb shell pm list 来查看,还可以加上不同的参数去查看不同类型的应用。而且也可以通过 adb 命令来清除应用相关的数据。
- 显示设备中安装的所有应用:
adb shell pm list packages - 只显示系统应用:
adb shell pm list packages -s - 只显示第三方应用:
adb shell pm list packages -3 - 删除与软件包关联的所有数据:
adb shell pm clear <包名>
adb shell dumpsys
dumpsys 是一种在 Android 设备上运行的工具,可提供有关系统服务的信息。可以使用 adb 从命令行调用 dumpsys,获取在连接的设备上运行的所有系统服务的诊断输出。
比如在测试中,如果需要通过 adb 命令启动 app,则需要知道 app 的包名和入口的 Activity 名。这个时候,就可以通过下面这条命令获取到这两个信息。
chuo >>> qrcode.ceba.ceshiren.com/link?name=a…
这个场景,需要先把要获取信息的应用启动,让它在前台运行,然后执行命令
adb shell dumpsys activity | grep mFocusedActivity
hogwarts@ ~ % adb shell dumpsys activity | grep mFocusedActivity
mFocusedActivity: ActivityRecord{9dae968 u0
com.xueqiu.android/.common.MainActivity t139}
下方的日志中就会展示出来当前的包名和 Activity 名称。
- 包名:
com.xueqiu.android - Activity 名:
.common.MainActivity
adb uiautomator
adb 命令还支持直接获取应用的页面信息。这个页面信息包含了页面中元素的属性,可以方便做自动化测试的时候去定位元素。获取到的页面布局会输出到一个 xml 文件中。
- 当前窗口的 UI 布局简化信息:
adb shell uiautomator dump --compressed
hogwarts@ ~ % adb shell uiautomator dump --compressed
UI hierchary dumped to: /sdcard/window_dump.xml
不指定输出文件路径时,dump 下来的文件默认存储路径为 /sdcard/window_dump.xml
可以通过 adb pull 命令把文件传输到电脑中,然后用 uiautomatorviewer 工具打开查看布局。
- 指定输出文件路径:
adb shell uiautomator dump file <设备路径>