Android ADB调试工具使用简记

一、ADB介绍

Android Device Bridge简称ADB，一般是作为上位机软件开发调试安卓手机，笔者在无人机、智能驾驶、清洁机器人产品开发中，都用到了ADB来调试，其实ADB不仅适合安卓系统，Linux类系统也可以用，相比于串口登录，更加方便。

ADB（Android Debug Bridge）是 Android SDK 中提供的一个命令行工具，用于在计算机与 Android 设备之间建立通信。通过 ADB，开发者可以在电脑上直接控制 Android 设备，实现应用安装、日志调试、文件传输、Shell 操作等功能。

ADB 在 Android 开发、系统调试、自动化测试以及设备维护等场景中被广泛使用。

ADB 采用客户端---服务器架构，主要由三个部分组成：

ADB Client：运行在电脑上的命令行工具
ADB Server：在电脑后台运行，负责管理客户端与设备通信
ADB Daemon (adbd)：运行在 Android 设备上的后台服务

通信流程如下：

电脑 ADB Client → 本地 ADB Server → Android 设备 adbd。

二、ADB 安装

ADB 工具通常包含在 Android SDK Platform Tools 中。

1. Linux / Ubuntu 安装

可以直接通过 apt 安装：

复制代码

sudo apt update
sudo apt install android-tools-adb android-tools-fastboot

安装完成后检查版本：

复制代码

adb version

2. Windows / Mac 安装

从 Android 官方下载 Platform Tools：

https://developer.android.com/tools/releases/platform-tools

解压后即可使用 adb 命令。

三、ADB 基本使用流程

使用 ADB 前，需要完成以下步骤：

打开 Android 手机 开发者模式
打开 USB 调试（USB Debugging）
使用 USB 连接电脑

然后执行：

复制代码

adb devices

如果设备连接成功，会显示类似：

复制代码

List of devices attached
emulator-5554   device
R9WN1234567     device

如果状态是：

复制代码

unauthorized

说明需要在手机上确认 USB 调试授权。

四、ADB 常用命令

1. 查看连接设备

复制代码

adb devices

显示当前连接的 Android 设备列表。

如果有多个设备，可以指定设备：

复制代码

adb -s 设备ID shell

2. 进入 Android Shell

复制代码

adb shell

进入 Android 设备终端，相当于远程登录到设备系统。

例如：

复制代码

adb shell
ls /sdcard

3. 安装 APK

安装应用：

复制代码

adb install app.apk

覆盖安装：

复制代码

adb install -r app.apk

安装完成后应用会自动出现在手机中。

4. 卸载应用

复制代码

adb uninstall 包名

例如：

复制代码

adb uninstall com.example.app

5. 文件传输

从电脑传到手机

复制代码

adb push 本地文件 设备路径

例如：

复制代码

adb push test.txt /sdcard/

从手机传到电脑

复制代码

adb pull 设备路径 本地路径

例如：

复制代码

adb pull /sdcard/test.txt .

6. 查看日志（Logcat）

Android 系统日志可以通过 logcat 获取：

复制代码

adb logcat

只看某个应用日志：

复制代码

adb logcat | grep 包名

清空日志：

复制代码

adb logcat -c

7. 重启设备

重启 Android 设备：

复制代码

adb reboot

进入 Bootloader：

复制代码

adb reboot bootloader

进入 Recovery：

复制代码

adb reboot recovery

8. 截图

使用 adb 进行截图：

复制代码

adb shell screencap /sdcard/screen.png
adb pull /sdcard/screen.png

9. 屏幕录制

复制代码

adb shell screenrecord /sdcard/demo.mp4

录制结束按 Ctrl + C。

然后下载：

复制代码

adb pull /sdcard/demo.mp4

五、ADB 无线调试

ADB 也支持 WiFi 调试。

1. USB 连接设备

复制代码

adb devices

2. 切换 TCP 模式

复制代码

adb tcpip 5555

3. 获取设备 IP

在手机上查看：

复制代码

设置 → 关于手机 → 状态 → IP地址

4. 连接设备

复制代码

adb connect 192.168.1.100:5555

之后即可无线调试。

六、ADB 常见问题

1. adb devices 看不到设备

可能原因：

USB 调试未开启
数据线不支持数据传输
USB 驱动未安装
没有授权 USB 调试

解决方法：

复制代码

adb kill-server
adb start-server
adb devices

2. 设备显示 unauthorized

解决方法：

拔掉 USB
手机关闭再打开 USB 调试
重新连接并授权

3. adb 命令找不到

如果提示：

复制代码

adb: command not found

说明 adb 没加入 PATH，可以手动添加：

复制代码

export PATH=$PATH:/path/to/platform-tools

七、ADB 的典型应用场景

ADB 在以下场景非常常见：

Android APP 开发调试
Android 系统调试
自动化测试
嵌入式 Android 设备维护
刷机与系统升级
日志分析与问题排查

在很多智能硬件设备（如无人机控制器、车机系统、智能终端）中，ADB 也是重要的调试工具。

八、总结

ADB 是 Android 开发和调试中最重要的工具之一。通过简单的命令行操作，开发者可以完成设备控制、应用安装、日志调试和文件传输等多种任务。

掌握 ADB 工具，可以显著提高 Android 系统调试和开发效率，是每个 Android 开发者必备的基础技能。

如果需要进一步深入，可以学习：

ADB 自动化脚本
ADB 与 CI/CD 集成
ADB 调试 Android 系统服务
ADB 与 Fastboot 刷机工具

熟练掌握这些工具，将大大提升 Android 平台的开发与调试能力。