ADB 连接使用说明

ADB 连接使用说明(Windows & macOS)

1. 什么是 ADB?

ADB(Android Debug Bridge)是 Android 开发/调试的通用工具,它允许你通过命令行与 Android 设备(手机、平板、电视、车机等)进行通信,执行安装应用、查看日志、模拟点击等各种操作。


2. 环境配置(安装 ADB)

Windows 系统

  1. 下载 Platform-Tools
  2. 解压与放置
    • 将下载的 platform-tools.zip 解压到一个无中文空格的路径,例如 C:\adb。
  3. 配置系统环境变量(可选但推荐)
    • 右键点击“此电脑” → “属性” → “高级系统设置” → “环境变量”。
    • 在“系统变量”中找到 Path 变量,点击“编辑” → “新建”,填入你的 ADB 目录路径(如 C:\adb)。
    • 点击确定保存。
  4. 验证安装
    • 按 Win + R,输入 cmd 打开命令提示符,输入:
      adb version
      
    • 若显示版本号,则配置成功。

macOS 系统

  1. 通过 Homebrew 安装(推荐)
    • 打开终端(Terminal),执行:
      brew install android-platform-tools
      
  2. 手动下载安装(备选)
    • 同 Windows,下载官方 platform-tools.zip 并解压。
    • 将解压后的目录移动到 /usr/local/ 下,或直接使用绝对路径。
  3. 配置环境变量(手动安装时需要)
    • 编辑 Shell 配置文件(根据你的 Shell 类型选择 ~/.zshrc 或 ~/.bash_profile):
      export PATH=$PATH:/你的解压路径/platform-tools
      
    • 执行 source ~/.zshrc 使其生效。
  4. 验证安装
    • 终端输入:
      adb version
      

3. 设备连接准备(通用)

3.1 手机端开启开发者模式

  1. 进入“设置” → “关于手机”。
  2. 连续点击 “版本号” 7 次,直到提示“已进入开发者模式”。
  3. 返回“设置” → “系统” → “开发者选项”。
  4. 开启 “USB 调试” 和 “USB 安装”(如有)。

3.2 充电模式设置

  • 连接电脑时,将 USB 用途设置为 “传输文件(MTP)” 或 “传输照片(PTP)”,不要仅设为“仅充电”。

4. USB 有线连接(Windows & macOS)

操作步骤

  1. 使用数据线将 Android 设备连接至电脑。
  2. 打开终端(或 CMD),输入:
    adb devices
    
  3. 手机上会弹出 “允许 USB 调试吗?” 的授权弹窗,勾选“始终允许”,点击“确定”。
  4. 再次输入 adb devices,若看到类似以下输出,表示连接成功:
    List of devices attached
    ABC123DEF456    device
    

常见问题

现象 解决方法
设备显示 unauthorized 手机上重新确认授权弹窗,或撤销授权后重试(开发者选项内可重置)。
设备显示 offline 重新插拔数据线,重启 adb 服务:adb kill-server + adb start-server。
找不到设备(Windows) 安装手机品牌对应的官方 USB 驱动程序(如小米、华为、三星官网下载)。
找不到设备(macOS) 尝试更换数据线(建议使用原装线),或更换 USB 端口。

5. 无线连接(Wi-Fi ADB)

前置条件

  • 电脑和 Android 设备连接同一 Wi-Fi 网络。
  • 设备已通过 USB 连接并授权过(首次需有线配对)。

方法一:Android 11+ 无线调试(原生支持)

  1. 确保设备已连接 Wi-Fi。
  2. 进入“开发者选项” → 开启 “无线调试”。
  3. 点击“无线调试” → “使用配对码配对”。
  4. 记下显示的 IP 地址、端口 和 配对码。
  5. 电脑终端执行配对:
    adb pair 192.168.1.100:XXXXX
    # 输入配对码
    
  6. 配对成功后,执行连接:
    adb connect 192.168.1.100:XXXXX  # 注意:此处端口可能与配对时不同
    
  7. 执行 adb devices 确认状态为 device。

方法二:通过 USB 切换至无线(通用)

  1. 先用 USB 连接设备,确保 adb devices 能看到设备。
  2. 获取设备 IP 地址(在“关于手机” → “状态信息”中查看,或执行 adb shell ip addr show)。
  3. 执行切换命令:
    # 设置无线端口
    adb tcpip 5555
    # 断开 USB 线,连接设备
    adb connect 192.168.1.100:5555
    
  4. 成功后即可拔掉数据线进行无线调试。

断开无线连接

adb disconnect 192.168.1.100:5555

6. 常用 ADB 命令速查

功能 命令
查看已连接设备 adb devices
安装 APK adb install -r app.apk(-r 覆盖安装)
卸载应用 adb uninstall 包名
查看设备日志 adb logcat
截屏 adb shell screencap /sdcard/screen.png
adb pull /sdcard/screen.png
录屏 adb shell screenrecord /sdcard/demo.mp4
获取设备型号 adb shell getprop ro.product.model
重启 ADB 服务 adb kill-server + adb start-server
进入 Shell 交互 adb shell

7. 多设备管理

当连接多个设备时,命令需指定设备序列号:

# 查看所有设备及序列号
adb devices

# 指定设备执行命令
adb -s ABC123DEF456 install app.apk
adb -s ABC123DEF456 logcat

8. 排错 Check List

遇到连接问题时,请按顺序检查:

  • USB 数据线是否为原装/支持数据传输线(非仅充电线)。
  • 开发者选项中 USB 调试是否已开启。
  • 手机是否已授权电脑的 RSA 指纹。
  • 电脑端的 ADB 驱动是否安装正确(Windows 重点检查设备管理器)。
  • 是否关闭了第三方手机助手(如 360、豌豆荚),它们可能占用 ADB 端口。
  • 重启 ADB 服务:adb kill-server 再 adb start-server。

提示:无线连接受 Wi-Fi 信号影响较大,稳定性不如 USB,频繁进行大量数据传输(如长时间 logcat)建议使用有线连接。