2、环境搭建：在不同操作系统（Windows/macOS/Linux）上安装ADB工具、配置环境变量、验证安装是否成功

ADB（Android Debug Bridge，安卓调试桥）是Android SDK平台工具中的核心组件，它承担着PC与Android设备之间通信的桥梁作用。无论是日常的日志抓取、应用安装、文件传输，还是深度的系统调试、自动化测试，ADB都是开发者与测试人员最常用的基础工具。本章将系统讲解在Windows、macOS、Linux三大主流操作系统上完成ADB环境搭建的完整流程，包括安装方式选择、环境变量配置、安装验证以及常见问题的排查方法。环境搭建是后续所有调试工作的前提，一个干净、正确、可复现的ADB环境，能够显著提升开发与调试效率，避免因工具链问题导致的无效排障。

ADB 环境搭建架构总览 Windows SDK Manager / 手动下载 macOS Homebrew / SDK Manager Linux apt / yum / 手动安装 ADB 核心组件 platform-tools（adb / fastboot / etc.） 环境变量 PATH 配置 验证安装 adb version → adb devices → 连接真机/模拟器 常见排障 驱动 / 端口 / 权限 安装方式选择 → 环境变量配置 → 版本验证 → 设备连接验证 → 排障 图：ADB 环境搭建核心流程与验证路径

上图展示了ADB环境搭建的整体架构：三大操作系统通过不同的安装途径获取platform-tools，统一配置环境变量后，通过版本验证与设备连接验证确认环境可用，最终进入实际调试阶段。下面将分平台详细展开。

2.1 核心原理：ADB工具链的组成与工作模式

ADB采用经典的C/S（客户端-服务器）架构，由三个关键部分组成：客户端（运行在PC上的adb命令）、守护进程adbd（运行在Android设备上的后台服务）、服务器（运行在PC上的后台进程，负责管理客户端与adbd之间的通信）。当用户在终端输入adb命令时，客户端会向本机的5037端口发起连接请求，启动或复用ADB服务器，服务器再通过USB或TCP/IP与设备端的adbd建立通信。

理解这一架构对排障至关重要。例如，当执行adb devices时，如果服务器未启动，它会自动启动；如果5037端口被占用，则会导致连接失败。此外，ADB支持两种连接模式：USB模式（通过USB线缆连接，需开启设备的USB调试）和网络模式（通过adb connect IP:端口连接，适用于无线调试或远程设备）。

组件运行位置作用典型问题
adb clientPC端解析用户命令并发送给服务器命令不存在（PATH未配置）
adb serverPC端管理设备列表、转发命令端口被占用、版本不匹配
adbdAndroid设备执行具体调试指令未开启USB调试、驱动异常

在搭建环境时，我们主要关注的是客户端与服务器的安装配置，而adbd通常随Android系统预装，无需额外操作。但需要确保设备端的开发者选项与USB调试已开启，这是后续验证环节的基础。

2.2 Windows平台安装与配置

2.2.1 安装方式选择

Windows用户有三种主流安装途径，各有优劣：

  • 方式一：Android Studio SDK Manager（推荐）。安装Android Studio后，通过SDK Manager下载"Android SDK Platform-Tools"。这种方式的好处是后续开发中SDK组件统一管理，且能自动处理依赖关系。缺点是Android Studio体积较大，若仅需ADB则显得笨重。
  • 方式二：单独下载platform-tools压缩包。从Google官方或Android开发者网站下载platform-tools-latest-windows.zip，解压到任意目录（如C:\adb）。这种方式轻量、快速，适合仅需ADB命令的测试人员。
  • 方式三：使用包管理器（如Chocolatey）。执行choco install adb，适合习惯命令行管理的用户，但需注意包源的可信度。
经验建议：对于课程学习和日常调试，推荐方式二。下载后解压到C:\platform-tools，路径中避免使用中文和空格，以减少后续配置的潜在问题。

2.2.2 环境变量配置步骤

配置环境变量的目的是让系统在任何路径下都能识别adb命令。操作流程如下：

  1. 右键"此电脑" → 属性 → 高级系统设置 → 环境变量。
  2. 在"系统变量"中找到Path，点击编辑 → 新建，填入platform-tools的完整路径（如C:\platform-tools）。
  3. 点击确定保存，关闭所有窗口。
  4. 重新打开CMD或PowerShell，输入adb version验证。
# 验证命令
adb version
# 预期输出示例
Android Debug Bridge version 1.0.41
Version 34.0.4-10928546
Installed as C:\platform-tools\adb.exe

若提示"不是内部或外部命令"，说明Path配置未生效或路径错误。此时应检查路径是否准确，并确保新开的终端窗口已加载最新环境变量。

2.3 macOS平台安装与配置

2.3.1 安装方式选择

macOS用户最推荐使用Homebrew包管理器安装，命令简洁且便于后续升级：

# 安装Homebrew（若未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装ADB
brew install android-platform-tools

Homebrew会自动将adb安装到/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel），这些目录通常已在PATH中，无需额外配置。若使用Android Studio，也可通过SDK Manager安装，但Homebrew方式更轻量。

2.3.2 环境变量配置（如需要）

如果Homebrew安装后adb命令仍无法识别，需手动添加路径。编辑shell配置文件（zsh为~/.zshrc，bash为~/.bash_profile）：

# 编辑配置文件
nano ~/.zshrc

# 添加以下行（路径根据实际安装位置调整）
export PATH="/opt/homebrew/bin:$PATH"

# 使配置生效
source ~/.zshrc
注意：macOS从Catalina开始默认使用zsh，若使用bash需确认配置文件正确。另外，首次运行adb时，系统可能弹出"允许网络连接"的提示，需点击允许，否则adb server无法正常启动。

2.4 Linux平台安装与配置

2.4.1 基于Debian/Ubuntu的安装

# 更新软件源
sudo apt update

# 安装ADB
sudo apt install android-tools-adb android-tools-fastboot

安装完成后，adb会自动位于/usr/bin/adb，该目录已在PATH中，无需额外配置。对于Fedora/CentOS等使用yum/dnf的系统：

sudo dnf install android-tools

2.4.2 手动安装（适用于特殊发行版）

若包管理器中没有对应软件包，可下载Linux版platform-tools并手动配置：

# 下载并解压
wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip
unzip platform-tools-latest-linux.zip -d ~/

# 添加环境变量（以bash为例）
echo 'export PATH=$PATH:~/platform-tools' >> ~/.bashrc
source ~/.bashrc

Linux下还需注意udev规则配置，否则普通用户无法访问USB设备。在/etc/udev/rules.d/下创建规则文件，添加设备厂商ID（如Google的18d1）：

# 创建规则文件
sudo nano /etc/udev/rules.d/51-android.rules

# 内容示例（替换为实际厂商ID）
SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev"

# 重载规则
sudo udevadm control --reload-rules

2.5 安装验证与设备连接测试

无论哪个平台，安装完成后都应执行一套标准验证流程，确保环境真正可用：

验证步骤命令预期结果失败排查方向
版本验证adb version显示版本号与安装路径PATH配置错误、文件缺失
服务启动adb start-server提示启动成功端口占用、权限不足
设备列表adb devices显示设备序列号与状态USB调试未开、驱动问题
连接测试adb shell echo ok输出"ok"设备授权弹窗未确认
实战案例：某测试人员在Windows上完成安装后，执行adb devices始终显示"List of devices attached"但无设备。排查过程：①确认手机已开启开发者选项和USB调试；②更换USB线缆和数据接口（部分线缆仅支持充电）；③在设备管理器中发现"Android Composite ADB Interface"带有黄色感叹号，更新驱动后恢复正常。此案例说明，驱动问题是Windows平台最常见的坑，建议安装手机厂商官方USB驱动或使用Windows Update自动搜索。

对于macOS和Linux，常见问题包括：未授权调试（设备上需点击"允许USB调试"弹窗）、USB权限不足（Linux下需配置udev规则）、以及使用Type-C转接口时的不兼容问题。

2.6 常见误区与总结复盘

  • 误区一：只装adb不装fastboot。platform-tools中同时包含adb和fastboot，后者用于刷机等底层操作，建议一并保留。
  • 误区二：修改环境变量后不重启终端。环境变量只在新的终端会话中生效，需重新打开CMD或source配置文件。
  • 误区三：忽略设备端授权。首次连接时设备会弹出RSA指纹确认框，若不点击"允许"，adb devices会显示"unauthorized"状态。
  • 误区四：使用过旧的ADB版本。新版Android设备可能要求更高版本的ADB，建议定期更新platform-tools。
← 上一章 📖 返回目录 下一章 →