如何配置adb环境win10

题图来自Unsplash，基于CC0协议

导读

配置 ADB 环境 Win10：从安装到调试的完整指南

要使用 Android Debug Bridge (ADB) 工具来调试和与你的 Windows 10 设备或模拟器交互，首先需要正确地配置 ADB 环境。ADB 是 Android 开发工具包中的一个关键命令行工具。下面将详细介绍如何下载、安装、配置 ADB 环境变量，并解决常见问题。

1. 了解 ADB 是什么以及你需要什么 ADB 允许你在开发电脑和 Android 设备之间通过命令行进行通信，可以执行安装 APK、设备重启、屏幕截图、查看日志等操作。 在 Windows 10 上使用 ADB 通常需要两个主要部分：

   • Android SDK Platform-Tools： 这个包里包含了 ADB、Fastboot 等核心命令行工具，可以从 Android Studio 的 SDK 工具中单独下载。
   • ADB Driver： 要让你的 Windows 10 电脑识别你的 Android 设备，需要为设备的 USB 端口安装正确的驱动程序。否则，ADB 可能无法与设备通信，显示 "authorizing mode" 或找不到设备。

2. 下载并安装 ADB (Platform-Tools) 首先，你需要获取 ADB 工具。最简单的方法是从官方网站下载：

   • 访问 Android Developers - Platform Tools 页面。
   • 下载最新版本的 platform-tools-windows.zip 文件。
   • 解压下载的压缩文件到一个方便记忆的位置，例如 C:AndroidPlatformTools （请确保路径中不要包含特殊字符或空格，或者在后续配置环境变量时妥善处理路径中的空格和分号）。

3. 安装 ADB 驱动程序 不同的 Android 设备可能需要不同类型的驱动。幸运的是，许多现代设备都能被 ADB 的通用驱动识别，但为了确保兼容性，特别是如果你遇到设备无法识别的问题，最好先获取并安装设备制造商提供的特定 ADB driver:

   • 方法一（通用）： Windows 10 通常能找到并提供下载 ADB 驱动的链接。
     • 连接你的 Android 设备到电脑。
     • 打开设备管理器 (devmgmt.msc)。
     • 展开 "通用串行总线控制器"。
     • 找到类似 "Android ADB Interface" 或 "Android Composite Device" 的设备。选择它，右键点击，选择 "更新驱动程序"。
     • 选择 "浏览我的电脑以查找驱动程序软件" -> "让我从计算机上的可用驱动程序列表中选择"。
     • 在厂商列表中，确保选择了 "Microsoft"。
     • 在设备列表中，选择 "Android Debug Bridge for Windows v10 (Intel x86 或 AMD x86_64)" (如果你的系统是 64 位，通常选择后缀为 x86_64 的版本)。点击 "下一步" 安装。
   • 方法二（下载特定设备驱动）： 如果通用驱动不起作用，或者设备管理器显示未知设备/驱动程序已损坏：
     • 访问你设备制造商的官方网站 (例如华为、小米、三星等)。
     • 进入支持或驱动下载页面，搜索你的具体设备型号，并查找 "ADB"、"Android USB Driver" 或 "Fastboot Driver"。
     • 下载正确的驱动程序。
     • 解压下载的驱动文件（如果需要）。
     • 重新连接设备。
     • 打开设备管理器，找到问题设备，右键选择 "更新驱动程序" -> "浏览计算机以查找驱动程序软件" -> 导航到你刚才下载并解压的驱动程序文件夹 -> 选择设备并安装。

4. 配置系统环境变量 (关键步骤) 配置环境变量是让系统在任意目录下都能识别和运行 adb 命令的基础。

   • 右键点击 "此电脑" 或 "我的电脑"，选择 "属性"。
   • 在左侧点击 "高级系统设置"。
   • 在 "系统属性" 窗口中，点击 "环境变量"。
   • 在 "系统变量" 区域，点击 "新建"。
     • 变量名： 输入 ANDROID_HOME (或者 ANDROID_SDK_ROOT，取决于你使用的具体 SDK 版本和习惯，但用 ANDROID_HOME)，通常建议用 ANDROID_HOME。
     • 变量值： 输入存放 platform-tools 文件夹的完整路径，例如 C:\Android\PlatformTools （注意使用双反斜杠 C:\ 或 /C/Android/PlatformTools，反斜杠在路径中不能是单个，要替换为两个或使用正斜杠）。
   • 双击 已有的 Path 变量（在系统变量或用户变量下），在编辑窗口的变量值底部添加一个分号 ;，然后接着输入你上面定义的 ANDROID_HOME 变量所对应的路径（即 C:\Android\PlatformTools / C:AndroidPlatformTools）。
     • 不要直接在Path的原有字符串后面加分号和路径！ 先在变量值末尾添加一个分号（；），然后是你的平台工具路径。
     • 示例：原本的Path可能是 C:Program Files...，你需要在最后加上 ;%ANDROID_HOME% 代表的路径，但这里要注意 %ANDROID_HOME% 是变量，但是在编辑框里输入的是占位符，你需要点击 "变量值" 右上角的 "环境" 图标（通常是一个带有向下箭头的圆）来使用变量，或者简单地手动输入这个完整路径（确保使用正确的反斜杠！！）。最稳妥的方法是手动输入完整的平台工具路径，例如 C:AndroidPlatformTools。
   • 点击 "确定" 保存所有更改。

5. 验证 ADB 安装和环境配置是否生效 配置完成后，你需要检查 ADB 是否成功安装并能被系统正确识别。

   • 打开一个新的命令提示符窗口： 最重要的是，每一次调整环境变量后，必须打开一个新的命令提示符窗口（CMD.exe 或 PowerShell），或者重启 IDE，配置才会在当前会话中生效。在已经打开的旧窗口中，即使 echo %ANDROID_HOME% 显示了路径，也可能因为环境变量解析不立即生效而导致 adb 仍然无法识别。
   • 在新打开的命令提示符窗口中运行：
     • 输入 adb version 并按回车。如果看到了 ADB 的版本信息（例如 "Android Debug Bridge version 1.0.41"），恭喜，说明 ADB 已经成功安装并且环境变量配置正确。
     • 如果命令提示符不认识 "adb"：
       • 首先确认你打开的是全新窗口。
       • 检查环境变量 ANDROID_HOME 的值是否正确，以及 Path 变量是否包含该路径。
       • 确保路径中没有空格或非法字符，或者如果路径包含空格，环境变量的值和Path中的路径片段都需要正确引用。
       • 检查在第 3 步安装的 ADB 驱动是否成功，特别是设备管理器中对于你的 Android 设备是否正确识别并且驱动正常。
       • 尝试手动运行：C:AndroidPlatformToolsadb version，如果版本信息可以打印出来，那就说明环境变量配置可能还有点小问题，但最基础的 adb 文件可用。
       • 初始化过程：有时候，当 ADB 首次解析环境变量或ssid路径时，会在用户主目录下创建一个 .android 文件夹，并在其中生成一个 adb.exe 的快捷方式。你可以尝试直接运行这个快捷方式来访问 ADB 界面。如果这个快捷方式是成功的，它通常会携带正确的初始化信息，并能正常工作。这时，如果 adb version 在任何 CMD 窗口中有效，那么环境变量的配置才是真正生效的。但这通常是环境变量配置无误的情况下的冗余操作。

6. ADB 环境变量配置 Windows 10 常见问题解决方案

   • "adb is not recognized as an internal or external command"： 最常见的环境变量未配置好问题。
     • 检查步骤 4，确认 ANDROID_HOME 变量已正确设置和值，且 Path 变量包含 %ANDROID_HOME%.
     • 检查路径字符串是否存在错误（反斜杠是否正确）。
     • 确保在全新的命令提示符窗口尝试。
     • 确认 ADB 文件确实存在于指定路径下。
   • 设备未被识别：
     • 检查设备是否开启 USB 调试模式（通常在开发者选项中）。
     • 检查 USB 连线是否良好。
     • 在设备上拉起开发者选项并授权 USB 调试连接请求（通常会弹窗）。
     • 检查 ADB 驱动是否正确安装，参考步骤 3 方法一和二。
     • 尝试不同的 USB 端口或数据线。
     • 在命令提示符中测试：adb devices，看是否能看到设备列表。这个命令可以帮你判断是设备驱动问题（看不到设备）还是设备连接问题、授权问题（看到设备列表但未授权）。
     • 桌面快捷方式问题：尝试按照第 5 步的方法，使用桌面上生成的 ADB 快捷方式来启动。
   • 设备类型错误或驱动冲突： 如果你的设备支持多种连接方式（如 CDP、RNDIS、ADB 等），Windows 可能选择了默认的驱动，导致 ADB 无法通信。可以在设备管理器中找到设备，尝试卸载而不安装驱动，然后重新连接设备，让 Windows 尝试安装其他匹配的驱动，或者手动指定安装 ADB 所需的特定 driver。

通过以上步骤，你应该能够在 Windows 10 系统上成功配置 ADB 环境。记得将 Platform-Tools 放在合适的位置，并正确配置环境变量，这将使你在开发或调试过程中更加方便高效。祝你配置顺利！