跳至主要內容

安卓（Android） adb教程

熊黎龙2024年6月22日android大约 11 分钟约 3217 字

adb(Android Debug Bridge)

adb命令指南 github
adb命令指南 网页

针对移动端 Android 的测试， adb 命令是很重要的一个点，必须将常用的 adb 命令熟记于心， 将会为 Android 测试带来很大的方便，其中很多命令将会用于自动化测试的脚本当中。

adb 其实就是 Android Debug Bridge, Android 调试桥的缩写，adb 是一个 C/S 架构的命令行工具，主要由 3 部分组成：

  • 运行在 PC 端的 Client : 可以通过它对 Android 应用进行安装、卸载及调试

    Eclipse 中的 ADT、SDK Tools 目录下的 DDMS、Monitor 等工具，都是同样地用到了 adb 的功能来与 Android 设备进行交互。

    PC 端的手机助手，诸如 360 手机助手、豌豆荚、应用宝等，其除了安装第三方应用方便，其他的功能，基本上都可以通过 adb 命令去完成，这里建议测试人员尽量不要在电脑上安装这类手机助手，因为其自带的 adb 程序可能会与 Android SDK 下的 adb 程序产生冲突，5037 端口被占用，导致使用 adb 命令时无法连接到设备

  • 运行在 PC 端的 Service : 其管理客户端到 Android 设备上 adb 后台进程的连接

    adb 服务启动后，Windows 可以在任务管理器中找到 adb.exe 这个进程

  • 运行在 Android 设备上的 adb 后台进程

    执行 adb shell ps | grep adbd ，可以找到该后台进程，windows 请使用 findstr 替代 grep

    [xuxu:~]$ adb shell ps | grep adbd
root      23227 1     6672   832   ffffffff 00019bb4 S /sbin/adbd

    这里注意一个地方，就是 adb 使用的端口号，5037，有必要记一下

    接下来我将 adb 命令分为三部分进行介绍，adb 命令、adb shell 命令、linux 命令

官方文档

http://adbshell.com/commands

其他文档：

https://blog.csdn.net/zhonglunshun/article/details/78362439

为命令指定目标设备

如果只有一个设备/模拟器连接时，可以省略掉 [-d|-e|-s ] 这一部分，直接使用 adb。

如果有多个设备/模拟器连接，则需要为命令指定目标设备。

参数含义
-d指定当前唯一通过 USB 连接的 Android 设备为命令目标
-e指定当前唯一运行的模拟器为命令目标
-s <serialNumber>指定相应 serialNumber 号的设备/模拟器为命令目标
adb -s cf264b8f shell wm size

adb 命令

获取设备列表

adb devices

获取设备的状态

adb get-state

设备的状态有 3 钟，device , offline , unknown

device：设备正常连接 offline：连接出现异常，设备无响应 unknown：没有连接设备

结束和启动 adb 服务

adb kill-server

adb start-server

通常两个命令一起用

一般在连接出现异常，使用 adb devices 未正常列出设备， 设备状态异常时使用 kill-server，然后运行 start-server 进行重启服务。

打印 Android 的系统日志

adb logcat

用于分析错误

打印dumpsys、dumpstate、logcat的输出

adb bugreport > d:\bugreport.log

用于分析错误

输出比较多，建议重定向到一个文件中

安装应用

覆盖安装是使用 -r 选项

adb install

windows 下如果需要安装含有中文名的 apk ，需要对 adb 进行修改，百度可以找到做出修改的adb , 支持中文命令的 apk，请自行搜索

卸载应用

后面跟的参数是应用的包名，请区别于 apk 文件名

-k 选项，卸载时保存数据和缓存目录

adb uninstall

将 Android 设备上的文件(夹)复制到电脑

# 例如复制 Sdcard 下的 pull.txt 文件到 D 盘：
adb pull sdcard/pull.txt d:\
# 复制并重命名
adb pull sdcard/pull.txt d:\rename.txt

注意权限，复制系统权限的目录下的文件，需要 root ，并且一般的 Android 机 root 之后并不能使用命令去复制，而需要在手机上使用类似于 RE 的文件浏览器，先对系统的文件系统进行挂载为可读写后，才能在手机上复制移动系统文件，这里推荐使用小米手机的开发版本，IUNI 也是不错滴~~

推送本地文件至 Android 设备

# 例如推送 D 盘下的 push.txt 至 Sdcard：
adb push d:\push.txt sdcard/

sdcard 后面的斜杠不能少，否则会出现下面的错误：

failed to copy 'push.txt' to 'sdcard': Is a directory

获取 root 权限，并挂载系统文件系统为可读写状态

adb root
adb remount

# 恢复非root权限
adb unroot

只针对类似小米开发版的手机有用

重启 Android 设备

# 重启
adb reboot
# 重启后，进入fastboot模式(同 adb reboot-bootloader 命令)
adb reboot bootloader
# 重启后，进入recovery模式
adb reboot recovery

将宿主机上的某个端口重定向到设备的某个端口

adb forward tcp:1314 tcp :8888

执行该命令后所有发往宿主机 1314 端口的消息、数据都会转发到 Android 设备的 8888 端口上，因此可以通过远程的方式控制 Android 设备。

远程连接 Android 设备

  1. 手机、PC处于相同的网络下，手机 root ，安装应用 adbWireless ，启动应用后点击界面中间的按钮

  2. 运行下面连接命令，即可通过无线的方式连接手机，缺点是速度比较慢

    adb connect 192.168.1.102

adb shell 命令

adb 命令是 adb 这个程序自带的一些命令，而 adb shell 则是调用的 Android 系统中的命令，这些 Android 特有的命令都放在了 Android 设备的 system/bin 目录下

获取已安装的应用信息

pm 因为全称Package Manager

直接运行 adb shell pm 可以获取到该命令的帮助信息

# 列出所有的应用的包名
adb shell pm list package
# 列出系统应用
adb shell pm list package -s
# 列出第三方应用
adb shell pm list package -3

# 列出应用包名及对应的apk名及存放位置
adb shell pm list package -f
# 列出应用包名及其安装来源
adb shell pm list package -i

# 查找三方应用中知乎的包名、apk存放位置、安装来源
adb shell pm list package -f -3 -i zhihu
#查找三方应用中QQ的包名、apk存放位置、安装来源
adb shell pm list package -f -3 -i qq

# 列出对应包名的 .apk 位置
adb shell pm path com.tencent.mobileqq
# 列出含有单元测试 case 的应用
adb shell pm list instrumentation
# 列出指定应用的 dump 信息
adb shell pm dump com.tencent.mobileqq

# 安装应用（目标apk存放于Android设备上，请用 pm install 安装）
adb shell pm install ...
# 卸载应用，同 adb uninstall , 后面跟的参数都是应用的包名
adb shell pm uninstall ...
# 清除应用数据
adb shell pm clear ...
# 设置和获取应用安装位置
# (0/auto:自动,1/internal:手机内部,2/external:外部存储)
adb shell pm set-install-location ...
adb shell pm get-install-location ...

am

am是ActivityManager，用于应用交互

参数解释
start [options] <INTENT>启动 <INTENT> 指定的 Activity
startservice [options] <INTENT>启动 <INTENT> 指定的 Service
broadcast [options] <INTENT> 发送 <INTENT> 指定的广播
force-stop <packagename>停止 <packagename> 相关的进程
kill-all杀死后台所有进程
kill <Package>参数是包名，杀死指定包名的进程
display-size WxH改变显示的分辨率，有的可能不支持
display-density <dpi>改变显示的density，有的可能不支持

<INTENT> 参数很灵活，和写 Android 程序时代码里的 Intent 相对应。用于决定 intent 对象的选项如下：

参数解释
-a <ACTION>指定 action，比如 android.intent.action.VIEW
-c <CATEGORY>指定 category，比如 android.intent.category.APP_CONTACTS
-n <COMPONENT>指定完整 component 名，用于明确指定启动哪个 Activity，如 com.example.app/.ExampleActivity
启动一个 Activity
adb shell am start ...
启动相机（例子）
# 启动相机
adb shell am start -n com.android.camera/.Camera
# 先停止目标应用，再启动
adb shell am start -S com.android.camera/.Camera
# 等待应用完成启动
adb shell am start -W com.android.camera/.Camera
启动默认浏览器
adb shell am start -a android.intent.action.VIEW -d http://www.baidu.com
启动拨号器
adb shell am start -a android.intent.action.CALL -d tel:10086
启动一个 instrumentation
adb shell am instrument

单元测试或者 Robotium 会用到

监控 crash 与 ANR
adb shell am monitor
结束应用
# 结束应用,后跟包名
adb shell am force-stop ...
启动一个服务
adb shell am startservice
发送一个广播
adb shell am broadcast
发短信消息
adb shell am start -a android.intent.action.SENDTO -d smsto:发送号码 --es sms_body 短信内容

查询短信消息：

1.手机需ROOT;2.需找到短信数据库文件

数据库文件路径：'/data/data/com.android.providers.telephony/databases/mmssms.db'，其中‘mmssms.db’文件就是保存短信内容的数据库文件，可利用正则表达式匹配。

打开热点界面
# 打开热点界面
adb shell am start -n com.android.settings/.TetherSettings
开启蓝牙
 adb shell am start -a android.bluetooth.adapter.action.REQUEST_ENABLE

发送按键事件

发送文本内容
adb shell input text test123456

先将键盘设置为英文键盘，不能发送中文

发送按键事件
# 模拟按下 Home 键
adb shell input keyevent KEYCODE_HOME

源码里面有定义：public static final int KEYCODE_HOME = 3;

因此可以将命令中的 KEYCODE_HOME 替换为 3

其他事件举例：

KEYCODE_BACK返回键
KEYCODE_DPAD_UP上键
KEYCODE_DPAD_DOWN下键
对屏幕发送一个触摸事件
# 点击屏幕上坐标为 500 500 的位置
adb shell input tap 500 500
滑动事件
# 从右往左滑动屏幕
adb shell input swipe 900 500 100 500

# 如果版本不低于 4.4 , 可以模拟长按事件
adb shell input swipe 500 500 501 501 2000

长按动作: 其实就是在小的距离内，在较长的持续时间内进行滑动，最后表现出来的结果就是长按动作

截图

# 截屏，保存至 sdcard 目录
adb shell screencap -p /sdcard/screen.png

录制命令

adb shell screenrecord sdcard/record.mp4

执行命令后操作手机，ctrl + c 结束录制，录制结果保存至 sdcard

获取当前界面的控件信息

# 获取控件信息
adb shell uiautomator dump
# 执行UI自动化测试
adb shell uiautomator runtest

不加 [file] 选项时，默认存放在 sdcard 下

输入法

# 列出设备上的输入法
adb shell ime list -s
# 选择输入法
adb shell ime set com.tencent.qqpinyin/.QQPYInputMethodService

获取设备分辨率

adb shell wm size

网络

开启和关闭WIFI功能

通过shell命令实现wifi的连接控制只需要一下四步：

# 1. 关闭WIFI
adb shell svc wifi disable
# 2. 修改/data/misc/wifi/wpa_supplicant.conf配置文件
# 3. 删除/data/misc/wifi/networkHistory.txt缓存文件
# 4. 开启WIFI
adb shell svc wifi enable
开启和关闭移动网络
# 开启移动网络
adb shell svc data enable
# 关闭移动网络
adb shell svc data disable
USB网络共享模式
# 打开USB网络共享
adb shell svc usb setFunctions rndis
# 关闭USB网络共享，打开媒体传输协议(mtp,Media Transfer Protocol)
adb shell svc usb setFunctions mtp

# 如果没有锁屏，打开USB网络共享
adb shell svc usb setScreenUnlockedFunctions rndis

# 获取当前USB模式
adb shell svc usb getFunctions

飞行模式

# 打开飞行模式
adb shell settings put global airplane_mode_on 1
adb shell am broadcast -a android.intent.action.AIRPLANE_MODE --ez state true

# 关闭飞行模式
adb shell settings put global airplane_mode_on 0
adb shell am broadcast -a android.intent.action.AIRPLANE_MODE --ez state false

shell方式的飞行只能开关data数据流量，不能关闭wifi

android 7 可以用，android 8之后 系统不予许第三方软件去设置飞行模式，除非你的app是系统应用，得到了root权限。

GPS

# 打开GPS
adb shell settings put secure location_providers_allowed +gps
# 关闭GPS
adb shell settings put secure location_providers_allowed -gps

monkey

# 在 PC 端执行 monkey 命令，将信息保存至 D 盘 monkey.log
adb shell monkey -p com.android.settings 5000 > d:\monkey.log
# 在 PC 端执行 monkey 命令，将信息保存至手机的 Sdcard
adb shell "monkey -p com.android.settings 5000 > sdcard/monkey.log"

第二个命令需要引号，否则这里肯定会报错，因为最终是写向了 PC 端当前目录的 sdcard 目录下，而非写向手机的 Sdcard

请参考 Android Monkey 的用法

settings

Settings.java，请参考 探究下 Android4.2 中新增的 settings 命令

dumpsys

请参考 android 中 dumpsys 命令使用

log

可以在 logcat 里面打印你设定的信息

adb shell log -p d -t xuxu "test adb shell log"

-p：优先级，-t：tag，标签，后面加上 message

查看 Android 设备的参数信息

# 查看所有参数键值对
adb shell getprop
# 获取设备的 sdk 版本
adb shell getprop ro.build.version.sdk
# 获取android版本号
adb shell getprop ro.build.version.release
# 获取机型
adb shell getprop ro.product.model
# 获取品牌
adb shell getprop ro.product.brand
# 获取所有产品信息
adb shell getprop | findstr product

APN

https://www.jianshu.com/p/cb9837d58ab7

linux命令

操作你的 Android 设备，常用到的命令，只列出，不详解！

cat、cd、chmod、cp、date、df、du、grep、kill、ln、ls、lsof、netstat、ping、ps、rm、rmdir、top、touch、重定向符号 ">" ">>"、管道 "|"

有些可能需要使用 busybox ，另外建议 windows 下 安装一个 Cygwin , 没用过的请百度百科 Cygwin

懂生活，懂编程
Copyright © 2026 熊黎龙