2. 环境搭建与基础:ADB驱动安装、platform-tools配置、环境变量设置、ADB版本确认
说实话,很多同学刚开始学ADB,第一步就卡在环境搭建上。我见过太多人下载了工具却跑不起来,最后发现是驱动没装对,或者环境变量配错了。这一章,咱们就把这些基础工作一次性搞定。
你想想看,ADB说白了就是电脑和Android设备之间的一座桥。桥没搭好,后面再牛的命令也传不过去。所以,别嫌这些步骤琐碎,它们是你后面所有操作的地基。
2.1 ADB驱动安装
驱动这东西,Windows用户最头疼。Mac和Linux用户反而省心,基本上插上就能用。我个人的经验是,先别急着装各种“驱动精灵”,咱们手动来,心里更有底。
2.1.1 Windows下的驱动安装
不同的手机厂商,驱动安装方式略有不同。但核心逻辑是一样的:让Windows认识你的设备。
- 自动安装(推荐)
- 下载并安装手机厂商的官方USB驱动包。
- 或者使用Google官方提供的
USB Driver(在Android SDK Manager里可以找到)。
- 手动安装(备选)
- 手机连接电脑,打开“开发者选项”和“USB调试”。
- 在电脑的“设备管理器”里,找到带黄色感叹号的设备(通常是“Android”或“其他设备”)。
- 右键点击,选择“更新驱动程序” → “浏览我的电脑以查找驱动程序”。
- 指向你下载好的驱动文件夹,让系统自己搜。
2.1.2 Mac / Linux下的驱动安装
Mac和Linux用户就简单多了。基本上不需要额外安装驱动,系统自带。
- Mac: 插上设备,打开终端,输入
system_profiler SPUSBDataType,如果能找到你的设备,就说明系统认出来了。 - Linux: 可能需要配置一下
udev规则。创建一个/etc/udev/rules.d/51-android.rules文件,在里面加上你的设备ID。具体ID可以用lsusb命令查到。
2.2 platform-tools配置
驱动装好了,接下来就是ADB工具本身了。Google官方把ADB、fastboot这些工具打包在一起,叫做 platform-tools。
2.2.1 下载platform-tools
别去第三方网站乱下,直接去Android开发者官网下载,最安全。
- 打开浏览器,搜索“Android platform-tools download”。
- 找到Google官方的下载页面(通常是一个
developer.android.com的链接)。 - 根据你的操作系统,下载对应的压缩包(Windows选 .zip,Mac选 .darwin.zip,Linux选 .linux.zip)。
2.2.2 解压与放置
下载完后,解压到一个你记得住的地方。我个人习惯放在硬盘的根目录下,比如 C:\platform-tools 或者 ~/platform-tools。路径里最好不要有中文和空格,免得后面出一些莫名其妙的问题。
adb.exe(Windows)或 adb(Mac/Linux)、fastboot.exe、AdbWinApi.dll 等文件。这些就是我们的“武器”。
2.3 环境变量设置
这一步很关键。设置环境变量的目的,就是让你在任意目录下都能直接敲 adb 命令,而不用每次都先跑到 platform-tools 文件夹里去。
2.3.1 Windows环境变量配置
- 右键点击“此电脑” → “属性” → “高级系统设置”。
- 点击“环境变量”。
- 在“系统变量”里,找到
Path变量,双击它。 - 点击“新建”,把
platform-tools的完整路径粘贴进去(比如C:\platform-tools)。 - 一路点“确定”保存。
2.3.2 Mac / Linux环境变量配置
Mac和Linux用户,需要修改你的shell配置文件。如果你用的是 bash,就改 ~/.bash_profile 或 ~/.bashrc;如果是 zsh(Mac新系统默认),就改 ~/.zshrc。
# 打开配置文件
vim ~/.zshrc
# 在文件末尾添加一行
export PATH=$PATH:~/platform-tools
# 保存退出后,让配置生效
source ~/.zshrc
2.4 ADB版本确认
环境配好了,咱们来验证一下。打开命令行,输入下面这个命令:
adb version
如果一切正常,你会看到类似下面的输出:
Android Debug Bridge version 1.0.41
Version 33.0.3-8952118
Installed as C:\platform-tools\adb.exe
看到版本号了,就说明环境搭建成功了。嗯,这里要注意,版本号后面的数字(比如 33.0.3)代表了ADB的版本。通常来说,版本越新,支持的设备和功能就越多。我建议你定期去官网看看,更新到最新版。
'adb' 不是内部或外部命令,说明环境变量没配好,或者路径写错了。回去检查一下 Path 变量里的路径,是不是真的指向了 platform-tools 文件夹。
2.5 知识体系总览
为了让你对整个环境搭建流程有个直观的认识,我画了一张图。你可以把它当成一张“藏宝图”,按图索骥,一步到位。
2.6 常见问题与避坑指南
环境搭建过程中,总会遇到一些奇奇怪怪的问题。我把这些年遇到过的、以及学员问得最多的几个问题,整理成了一张表,方便你对照排查。
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
adb 命令找不到 |
环境变量未配置或配置错误 | 检查 Path 变量中的路径是否正确 |
设备显示 unauthorized |
手机未授权电脑的调试请求 | 在手机上点击“允许USB调试”,并勾选“一律允许” |
设备显示 offline |
ADB版本与设备不兼容,或驱动有问题 | 更新ADB到最新版,或重新安装驱动 |
| 设备管理器有黄色感叹号 | 驱动未正确安装 | 手动指定驱动路径,或使用驱动工具修复 |
Mac/Linux下 adb: command not found |
未执行 source 命令使配置生效 |
执行 source ~/.zshrc 或重启终端 |