1. ADB环境搭建与设备连接
任务目标
在本案例中,你将完成ADB(Android Debug Bridge)调试工具的环境搭建,配置系统环境变量,并成功连接一台Android设备或启动模拟器,最终通过adb devices命令验证设备连接状态。
环境准备
- 操作系统:Windows 10/11、macOS 或主流Linux发行版
- Android设备:开启开发者选项和USB调试(设置 → 关于手机 → 连续点击版本号7次 → 返回设置 → 开发者选项 → 打开USB调试)
- USB连接:使用数据线连接设备与电脑,手机弹出授权对话框时点击“允许”
- 模拟器(可选):Android Studio自带模拟器或第三方模拟器(如Genymotion)
ADB工具安装与环境变量配置
ADB工具包含在Android SDK Platform-Tools中。以下为各平台安装方式:
- Windows:下载
platform-tools.zip,解压到如C:\adb目录。右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 在Path中新增C:\adb。 - macOS:执行
brew install --cask android-platform-tools,安装后adb自动加入PATH。 - Linux:执行
sudo apt install android-tools-adb(Debian/Ubuntu)或对应包管理器安装。
安装完成后,打开新终端,执行adb version,若输出版本号则说明安装成功。
关键完整代码(终端命令)
以下命令在终端中依次执行,完成设备连接与状态验证:
# 1. 确认ADB已安装
adb version
# 2. 启动ADB服务(通常安装后自动启动,此命令可手动确保)
adb start-server
# 3. 查看当前连接的设备列表
# 若看到"List of devices attached"下方有设备序列号且状态为"device",则连接成功
adb devices
# 4. 若使用模拟器,需先启动模拟器,再执行:
# adb connect 127.0.0.1:5555 (部分模拟器端口不同,如Android Studio默认5554/5555)
# 5. 若设备显示"unauthorized",请检查手机USB调试授权弹窗并点击允许
# 若显示"offline",尝试重新插拔USB或执行 adb kill-server 后重新 adb start-server
验证方法与判定标准
执行adb devices后,观察输出结果:
- 通过:设备列表中出现
设备序列号 device,表示设备已正常连接并授权。 - 未通过:列表为空,或状态为
unauthorized(未授权)、offline(离线)。此时检查USB调试授权、数据线是否支持数据传输、驱动是否安装(Windows),或重启ADB服务后重试。
若使用模拟器,确认模拟器已启动且ADB端口正确,执行adb devices同样应看到emulator-5554 device之类的条目。
常见问题
- adb不是内部或外部命令:环境变量未配置成功,检查Path路径是否正确,并重新打开终端。
- 设备显示offline:尝试
adb kill-server后重新adb start-server,或更换USB端口/数据线。 - Linux下USB设备无权限:执行
sudo adb kill-server后,用sudo adb start-server重启服务,或在/etc/udev/rules.d/中添加设备规则。