[!info] related notes

• 命令速查: ADB 命令速查
• 所属配置: android-development-environment-setup
• 所属组件: android-platform-tools
• 同族笔记: android-sdk

ADB (Android Debug Bridge)

一句话定义

ADB 是 Android SDK 的命令行工具，提供 PC 与 Android 设备（真机或模拟器）之间的调试通道。

架构

主机 adb client
  → 主机 adb server（默认本地 TCP 5037）
    → USB 或网络连接
      → 设备 / 模拟器上的 adbd

client 发送命令，server 管理设备连接，adbd 在设备侧执行操作。调用 adb 不代表拥有设备 root 权限；可访问的文件、应用和 shell 能力仍受 Android 权限与设备构建限制。

连接方式

• USB 调试：开启开发者选项和 USB 调试，使用支持数据传输的线缆，并在设备端认可主机授权。
• 无线调试配对：支持的 Android 版本提供配对码方式，可用 adb pair IP:配对端口，随后按设备显示的连接地址连接。配对端口与连接端口可能不同。
• 旧式 TCP/IP：通常先通过已授权 USB 连接执行 adb tcpip 5555，再 adb connect IP:5555；这是另一套流程，不能套在所有无线调试上。使用完按需切回 USB，并避免将调试端口暴露到不可信网络。

使用与判断

先运行 adb version 确认使用的工具，再用 adb devices -l 查看连接。

• 命令找不到：检查可执行文件及 PATH，ANDROID_HOME 本身不会把命令加入 PATH。
• 只有设备列表标题：adb 已运行，应检查线缆、USB 模式、调试设置及主机驱动 / 权限。
• unauthorized：设备尚未认可该主机，检查解锁后的授权提示。
• offline：连接尚不可用；排查设备状态和传输，重启 adb server 会影响该主机的其他调试会话。
• 多设备：用 adb -s SERIAL ... 明确目标。

安装、传输、日志和转发命令统一维护在 adb-command-cheatsheet。ADB 与 fastboot 是不同协议 / 工具；重启到 bootloader 后应按设备支持使用 fastboot，而不是继续假定 adb 可用。