Android Debug Bridge 备忘清单

ADB 既 Android Debug Bridge,是 Google 的 Android SDK 中的一个命令行工具,可让您的计算机控制 Android 设备执行各种设备操作。以下是您可以与 ADB 一起使用的一些最常见的命令及其用法

入门

设备基础

:----
adb devices列出已连接的设备
adb devices -l列出已连接的设备和种类
adb connect [IP:PORT]连接到指定 IP 和端口的设备
adb disconnect [IP:PORT]断开指定 IP 和端口的设备连接,若未指定,则断开所有连接
adb rootroot 权限重新启动 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
$ adb -s somedevice-1234 root

Logcat

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

示例

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

过滤日志输出

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

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

$ adb logcat *:W

文件管理

:----
adb push <local> <remote>将本地文件复制到远程设备
adb pull <remote> <local>将远程设备文件复制到本地

示例

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

远程 Shell

:----
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 <count>启动指定包名的应用程序, 并执行测试

包安装

:----
adb install <apk>安装应用程序
adb install <path>从手机路径安装应用
adb install -r <path>从手机路径安装应用(允许覆盖安装)
adb uninstall <name>卸载应用程序

Paths

:----
/data/data/<package>/databases应用程序数据库
/data/data/<package>/shared_prefs/共享偏好设置
/data/app用户安装的 APK
/system/app系统预装的 APK 文件
/mnt/asec加密的应用程序(App2SD)
/mnt/emmc内部 SD 卡
/mnt/sdcard外部/内部 SD 卡
/mnt/sdcard/external_sd外置 SD 卡

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

手机信息

:----
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'打印当前应用程序的打开活动的信息

包信息

:----
adb shell pm list packages列出包名称
adb shell pm list packages -f列出包名 + apks 的路径
adb shell pm list packages -3列出第三方包名称
adb shell pm list packages -s仅列出系统包
adb shell pm list packages -u列出出包和未安装包
adb shell pm list packages -i列出包名称 + 安装来源
adb shell pm list packages -e列出启用的包
adb shell pm list packages -d列出禁用的包
adb shell dumpsys package packages列出所有应用程序的信息
adb shell dumpsys package <name>列出一个包的信息
adb shell pm path <package>列出 APK 文件的路径

设备相关命令

:----
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打开画廊

权限

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

Logs

:----
adb logcat [options] [filter] [filter]查看设备日志
adb bugreport打印错误报告

常见的 ADB 命令

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

$ adb push example.apk /sdcard/Download/

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

$ adb shell pm list packages -f

从安卓设备中提取文件

$ adb pull /sdcard/Download/example.apk

从主机安装 APK 到 Android 设备

$ adb install example.apk

从 Android 设备存储安装 APK

$ adb install /sdcard/Download/example.apk

设置网络代理

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

禁用网络代理

$ adb shell settings put global http_proxy :0

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

$ adb devices
$ adb -s 7f1c864e shell

7f1c864e 是设备 ID

通过 IP 地址连接到设备

$ adb connect 192.168.56.101:5555

通过 Wi-Fi 连接 ADB

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

$ 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

$ adb tcpip $port

例如 5555:

$ adb tcpip 5555

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

$ adb connect $ip:$port

例如:

$ adb connect 192.168.1.4:5555

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

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

查找应用的 APK 路径

$ adb shell pm path com.example.myapp

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

通过名称查找应用的包名

$ adb shell pm list packages | grep app_name

从设备提取 APK 到您的计算机

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

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

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

滚动屏幕

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

发文本

使用虚拟键盘发送文本:

$ adb shell input text "Hello World"

发送按键事件

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

发送点击

点击屏幕:

$ adb shell input tap x y

查看包的日志

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

查看特定包的日志