ADB安装使用指南

ADB安装使用指南

本文介绍 ADB（Android Debug Bridge）在 Windows / macOS / Linux 的安装、配置与常用操作，适用于真机与云机连接场景。

ADB 是什么

ADB 是 Android 官方提供的调试桥接工具，可用于设备连接、应用安装、日志查看、文件传输和端口转发。

核心组成：

1. Client（客户端）：你在终端执行的 adb 命令。

2. Server（服务端）：本机后台进程，默认监听 5037 端口。

3. Daemon（adbd）：运行在 Android 设备上的守护进程。

安装前准备

1. 确保终端可访问外网，便于下载 Android SDK Platform-Tools。

2. 建议优先使用官方 platform-tools，避免第三方二次打包版本。

3. 若连接真机，请在手机端开启 开发者选项 与 USB 调试。

Windows 安装

1. 下载并解压 Android SDK Platform-Tools（建议解压到 C:\platform-tools）。

2. 配置环境变量：

   将 C:\platform-tools 添加到系统 Path。

3. 打开 PowerShell / CMD，执行：

   adb version

   若显示版本号，表示安装成功。

4. 首次 USB 连接手机后，手机会弹出 允许 USB 调试，点击允许。

macOS 安装

1. 方式一（推荐）：使用 Homebrew 安装 platform-tools：

   brew install android-platform-tools

2. 方式二：下载官方压缩包后手动解压，并将目录加入 PATH。

3. 验证安装：

   adb version

4. 如遇权限问题，可重新打开终端或检查 shell 配置文件（~/.zshrc / ~/.bashrc）。

Linux 安装

1. Ubuntu / Debian：

   sudo apt update && sudo apt install -y android-sdk-platform-tools

2. CentOS / RHEL（可能需 EPEL 或自备 platform-tools）：

   建议下载官方 platform-tools 压缩包手动安装。

3. 验证安装：

   adb version

4. 如 USB 设备无权限，可补充 udev 规则并重载服务。

首次连接与验证

1. 查看 ADB 服务状态：

   adb start-server

2. 列出在线设备：

   adb devices

3. 状态说明：

   device：可用；unauthorized：未授权；offline：连接异常。

无线与远程连接

局域网连接（示例）：

1. adb connect 192.168.1.10:5555

2. adb devices 确认状态为 device。

SSH 隧道连接云机（示例）：

3. 建立隧道：

   ssh user@host -p 1824 -L 8767:adb-proxy:53398 -Nf

4. 本地连接：

   adb connect localhost:8767

5. 说明：本地端口以 -L 左侧为准（示例中为 8767）。

常用命令

1. 查看设备：adb devices -l

2. 进入 shell：adb shell

3. 安装 APK：adb install app.apk

4. 覆盖安装：adb install -r app.apk

5. 卸载应用：adb uninstall 包名

6. 抓取日志：adb logcat

7. 推送文件：adb push 本地文件 /sdcard/

8. 拉取文件：adb pull /sdcard/文件 本地目录

9. 端口转发：adb forward tcp:7001 tcp:7001

10. 断开连接：adb disconnect

多设备操作

当有多台设备在线时，需使用 -s 指定序列号：

adb -s 设备序列号 shell

adb -s 设备序列号 install -r app.apk

常见问题排查

1. adb: command not found

   检查 platform-tools 是否安装、Path 是否生效，重开终端后重试。

2. unauthorized

   手机端确认 USB 调试授权；必要时执行 adb kill-server && adb start-server。

3. offline

   先 adb disconnect，再重新 adb connect；排查网络与端口是否可达。

4. 端口占用

   更换本地端口（如 -L 8768:...），并使用对应端口执行 adb connect localhost:8768。

5. 服务异常

   adb kill-server 后再 adb start-server，并重新检查 adb devices。

使用建议

1. 自动化场景建议固定 ADB 版本，避免环境漂移。

2. 批量控制设备时，始终显式指定 -s。

3. 云机场景优先使用 SSH 隧道，避免直接暴露调试端口。

4. 任务结束后关闭隧道与无用连接，减少资源占用。

注意：请仅在你拥有管理权限和授权的设备上使用 ADB 调试能力。