ADB命令备忘清单

ADB 即 Android Debug Bridge，是 Google 的 Android SDK 中的一个命令行工具，可让计算机控制 Android 设备执行各种设备操作。
本文整理一些 ADB 使用时最常见的命令及其用法。

入门

设备基础

Command	说明
`adb devices`	列出已连接的设备
`adb devices -l`	列出已连接的设备和种类
`adb connect [IP:PORT]`	连接到指定 IP 和端口的设备
`adb disconnect [IP:PORT]`	断开指定 IP 和端口的设备连接，若未指定，则断开所有连接
`adb root`	以 `root` 权限重新启动 `adbd`
`adb start-server`	启动 `adb` 服务
`adb kill-server`	停止 `adb` 服务
`adb remount`	重新挂载具有读/写访问权限的文件系统
`adb reboot`	重启设备
`adb reboot bootloader`	将设备重启到 fastboot 模式
`adb reboot recovery`	将设备重启到恢复模式
`adb disable-verity`	禁用设备的 dm-verity 安全特性

wait-for-device 可以在 adb 之后指定，以确保该命令在设备连接后运行
-s 可用于在多个连接时将命令发送到特定设备

示例

$ adb wait-for-device devices
 List of devices attached
 somedevice-1234 device
 someotherdevice-1234 device

1	$ adb -s somedevice-1234 root

Logcat

Command	说明
`adb logcat`	将日志消息打印到标准输出
`adb logcat -g`	显示当前日志缓冲区大小
`adb logcat -G <size>`	设置缓冲区大小（K 或 M）
`adb logcat -c`	清除日志缓冲区
`adb logcat *:V`	启用所有日志消息（详细）
`adb logcat -f <filename>`	将日志转储到指定文件

示例

1 2	$ adb logcat -G 16M $ adb logcat *:V > output.log

过滤日志输出

V 最详细的信息(最低优先级)
D 调试信息
I 普通信息
W 警告信息
E 错误信息
F 致命错误信息
S 静默(最高优先级)

例如，要显示优先级不低于 警告 的所有标记的所有日志消息，可以使用以下命令：

1	$ adb logcat *:W

文件管理

Command	说明
`adb push <local> <remote>`	将本地文件复制到远程设备
`adb pull <remote> <local>`	将远程设备文件复制到本地

示例

1
2
3

$ echo "This is a test" > test.txt
$ adb push  test.txt /sdcard/test.txt
$ adb pull /sdcard/test.txt pulledTest.txt

远程 Shell

Command	说明
`adb shell <command>`	在设备上运行指定的命令（大多数 Unix 命令在这里工作）
`adb shell wm size`	显示当前屏幕分辨率
`adb shell wm size WxH`	将分辨率设置为 WxH
`adb shell pm list packages`	列出所有已安装的应用包
`adb shell pm list packages -3`	列出所有已安装的第三方的应用包
`adb shell monkey -p app.package.name`	启动指定包名的应用程序

包安装

Command	说明
`adb shell install <apk>`	安装应用程序
`adb shell install <path>`	从手机路径安装应用
`adb shell install -r <path>`	从手机路径安装应用（允许覆盖安装）
`adb shell uninstall <name>`	卸载应用程序

Paths

Command	说明
`/data/data/<package>/databases`	应用程序数据库
`/data/data/<package>/shared_prefs/`	共享偏好设置
`/data/app`	用户安装的 APK
`/system/app`	系统预装的 APK 文件
`/mmt/asec`	加密的应用程序（App2SD）
`/mmt/emmc`	内部 SD 卡
`/mmt/adcard`	外部/内部 SD 卡
`/mmt/adcard/external_sd`	外置 SD 卡

Command	说明
`adb shell ls`	列出目录内容
`adb shell ls -s`	每个文件的打印尺寸
`adb shell ls -R`	递归列出子目录

手机信息

Command	说明
`adb get-statе`	打印设备状态
`adb get-serialno`	获取设备的序列号
`adb shell dumpsys iphonesybinfo`	获取设备的 IMEI 信息
`adb shell netstat`	列出设备上的所有 TCP 连接
`adb shell pwd`	打印当前工作目录
`adb shell dumpsys battery`	获取设备电池状态
`adb shell pm list features`	列出设备支持的所有功能
`adb shell service list`	列出设备上运行的所有服务
`adb shell dumpsys activity <package>/<activity>`	获取指定包和活动的信息
`adb shell ps`	打印设备上所有运行的进程状态
`adb shell wm size`	显示当前设备的屏幕分辨率
`dumpsys window windows` \| `grep -E 'mCurrentFocus\|mFocusedApp'`	打印当前应用程序的打开活动的信息

包信息

Command	说明
`adb shell list packages`	列出包名称
`adb shell list packages -r`	列出包名 + apks 的路径
`adb shell list packages -3`	列出第三方包名称
`adb shell list packages -s`	仅列出系统包
`adb shell list packages -u`	列出包名称 + 已卸载
`adb shell dumpsys package packages`	列出所有应用程序的信息
`adb shell dump <name>`	列出一个包的信息
`adb shell path <package>`	列出 APK 文件的路径

设备相关命令

Command	说明
`adb reboot recovery`	重启设备进入恢复模式
`adb reboot fastboot`	重启设备进入恢复模式
`adb shell screencap -p "/path/to/screenshot.png"`	截图
`adb shell screenrecord "/path/to/record.mp4"`	录制设备屏幕
`adb backup -apk -all -f backup.ab`	备份设置和应用程序
`adb backup -apk -shared -all -f backup.ab`	备份设置、应用程序和共享存储
`adb backup -apk -nosystem -all -f backup.ab`	仅备份非系统应用程序
`adb restore backup.ab`	恢复以前的备份
`adb shell am start -a android.intent.action.VIEW -d URL`	打开网址
`adb shell am start -t image/* -a android.intent.action.VIEW`	打开画廊

权限

Command	说明
`adb shell permissions groups`	列出所有已定义的权限组
`adb shell list permissions -g -r`	列出了所有权限的详细信息

Logs

Command	说明
`adb logcat [options] [filter] [filter]`	查看设备日志
`adb bugreport`	打印错误报告

常见的 ADB 命令

将文件推送到 Android 设备的下载文件夹

1	$ adb push example.apk /sdcard/Download/

列出所有已安装的包并获取完整路径

1	$ adb shell pm list packages -f

从安卓设备中提取文件

1	$ adb pull /sdcard/Download/example.apk

从主机安装 APK 到 Android 设备

1	$ adb shell install example.apk

从 Android 设备存储安装 APK

1	$ adb shell install /sdcard/Download/example.apk

设置网络代理

1	$ adb shell settings put global http_proxy <address>:<port>

禁用网络代理

1	$ adb shell settings put global http_proxy :0

显示连接的设备并指定一个设备进行 Shell

1 2	$ adb devices $ adb -s 7f1c864e shell

7f1c864e 是设备 ID

通过 IP 地址连接到设备

1	$ adb connect 192.168.56.101:5555

通过 Wi-Fi 连接 ADB

我们可以通过 Wi-Fi 或专门使用 tcp 连接使用 adb。要通过 Wi-Fi 使用 adb，首先通过 USB 连接手机并启用 USB 调试。然后列出所有设备：

1
2
3

$ adb devices
# 这应该给出这样的输出：
# device_id    device

现在检查 Android 设备的 IP：

$ adb shell ifconfig
# 输出:

wlan0  Link encap:UNSPEC    Driver icnss
       inet addr:XXX.XXX.X.XX  Bcast:XXX.XXX.X.XXX

记下 inet addr 后的 IP 地址。稍后要用。现在在某个端口重新启动 tcpip：

1	$ adb tcpip $port

例如 5555：

1	$ adb tcpip 5555

现在可以断开 USB 线缆使用。若要连接到设备请键入以下命令：

1	$ adb connect $ip:$port

例如:

1	$ adb connect 192.168.1.4:5555

将计算机上的 APK 文件安装到设备

1	$ adb install /Users/dev/projects/myapp.apk

查找应用的 APK 路径

1	$ adb shell pm path com.example.myapp

将 com.example.myapp 替换为自己的应用程序包名称

通过名称查找应用的包名

1	$ adb shell pm list package \| grep app_name

从设备提取 APK 到计算机

1	$ adb pull /data/app/com.example.myapp.apk ./

将文件从计算机复制到设备

1	$ adb push path/to/local/file /sdcard/foo.txt

滚动屏幕

1 2	$ adb shell input swipe 300 300 500 1000 # 上 $ adb shell input swipe 500 1000 300 300 # 下

发文本

使用虚拟键盘发送文本：

1	$ adb shell input text "Hello World"

发送按键事件

1 2	$ adb shell input keyevent 66 # 66 是回车键码

发送点击

点击屏幕：

1	$ adb shell input tap x y

查看包的日志

1	$ adb shell 'logcat --pid=$(pidof -s <package_name>)'

查看特定包的日志