1. ADB环境搭建与设备连接
任务目标
在本机安装ADB(Android Debug Bridge)工具并配置环境变量,使终端可直接调用adb命令;随后连接一台Android设备(真机或模拟器),通过adb devices验证设备已被正确识别。
环境准备
- 操作系统:Windows 10/11、macOS 或主流Linux发行版均可。
- Android设备:真机需开启开发者选项与USB调试;模拟器(如Android Studio自带的AVD)无需额外设置。
- USB连接:真机通过数据线连接电脑,首次连接时在设备上允许USB调试授权。
安装与配置步骤
1. 下载ADB工具
访问Android开发者官网下载Android SDK Platform-Tools压缩包,解压到本地目录(例如 D:\platform-tools)。该压缩包内已包含adb.exe、fastboot.exe等必要文件,无需额外安装。
2. 配置环境变量
将解压目录添加到系统的PATH环境变量中,使adb命令可在任意终端路径下直接调用。
3. 验证安装
打开新的终端窗口,执行adb version,若输出版本号信息则说明安装成功。
核心代码与命令
以下为完整的安装验证与设备连接命令序列(Windows示例,macOS/Linux命令相同):
# 1. 验证ADB是否已正确安装(应输出版本号)
adb version
# 2. 启动ADB服务(通常会自动启动,此命令可手动确保)
adb start-server
# 3. 列出当前连接的设备
# 真机需已开启USB调试并授权;模拟器需已启动
adb devices
# 4. 若设备显示为"unauthorized",请在手机弹窗中点击"允许USB调试"
# 若设备显示为"offline",请重新插拔USB线或重启ADB服务:
adb kill-server
adb start-server
adb devices
# 5. 确认设备状态为"device"即表示连接成功
# 示例输出(设备序列号因机器而异):
# List of devices attached
# emulator-5554 device
环境变量配置说明(Windows):
右键“此电脑”→“属性”→“高级系统设置”→“环境变量”,在系统变量中找到Path,点击“编辑”→“新建”,填入ADB解压目录的完整路径(如 D:\platform-tools),保存后重新打开终端生效。
macOS/Linux 临时配置方法(仅当前终端有效):
export PATH=$PATH:/your/path/to/platform-tools
永久配置请将上述行追加到 ~/.bashrc 或 ~/.zshrc 中。
验证方法与通过条件
- 安装验证:执行
adb version能输出版本号(如Android Debug Bridge version 1.0.41),且不提示“不是内部或外部命令”。 - 连接验证:执行
adb devices后,列表中能看到目标设备且状态为device。若状态为unauthorized,在设备上点击允许调试后重新执行;若状态为offline,执行adb kill-server后重新adb start-server再试。 - 最终判定:设备状态为
device即表示ADB环境搭建完成且设备连接成功,可继续后续ADB实战操作。
常见问题
- adb未找到:确认环境变量路径正确,且终端是配置后新打开的窗口。
- 真机不识别:检查USB调试是否开启,尝试更换USB线/接口,或在设备上撤销USB调试授权后重新授权。
- 模拟器连接:Android Studio自带的AVD启动后会自动出现在
adb devices列表中,无需额外配置。