如果你喜欢摆弄手机或开发应用程序, ADB(Android调试桥)是用于从计算机控制设备的基本工具。它允许您执行从普通 Android 界面无法完成的操作,例如卸载系统预装软件、自动执行任务或访问手机的命令 shell。
直到最近,使用 ADB 时通常都需要 USB 数据线,但自从 Android 11 以来,情况发生了变化: 你可以通过 Wi-Fi 将手机连接到 ADB,而无需将其插入电脑。该系统包含一个无线调试选项,可通过二维码和配对码大大简化调试过程,并且在初始 USB 连接后,仍然可以通过 TCP/IP 使用旧的 ADB 方法进行调试。
什么是 ADB?为什么你应该对无线使用 ADB 感兴趣?
ADB 代表 Android 调试桥,它充当…… 使用控制台命令在您的计算机和 Android 设备之间建立通信桥梁它专为开发者设计,但对于想要超越图形界面功能限制的高级用户来说,它也是无比宝贵的工具。
该实用程序由三部分组成: 一个运行在您的 PC 上的客户端,一个运行在移动设备或模拟器上的守护进程 (adbd),以及一个协调两者的服务器。客户端发送命令,服务器分发命令,守护进程在设备上执行命令。每次你在终端输入 adb 命令时,所有这些操作都在后台进行。
使用 ADB,您可以完成所有操作: 安装和卸载应用程序、调试应用程序、访问完整的 Unix shell、复制文件、录制屏幕、截屏或重定向端口它甚至允许您在企业级别管理权限、用户配置文件或设备策略。
ADB的经典问题始终如一: 这取决于USB数据线是否完好,以及手机和电脑的接口是否处于良好状态。如果手机连接器损坏、电缆接触不良或 Windows 中的 USB 驱动程序出现问题,您可能会因为无法让电脑识别该设备而感到抓狂。
Android 11 在这方面取得了重大飞跃,引入了所谓的 无线调试功能允许您使用二维码或配对 PIN 码通过 Wi-Fi 将手机连接到设备。这样一来,无论是在开发过程中还是在许多高级用户任务中,您都可以忘记连接线的问题。
在 Android 11 或更高版本上使用无线 ADB 的基本要求

在开始之前,您需要明确一些最低要求,因为 并非所有手机或电脑配置都适用于现代无线调试。 谷歌推出的。
首先,你的手机需要运行 需要 Android 11 或更高版本才能在开发者选项中启用无线调试选项。在 Android 10 及更早版本中,ADB 也可以通过 Wi-Fi 使用,但使用的是基于 TCP/IP 和初始 USB 连接的旧方法。
在计算机方面,拥有以下条件至关重要: 更新后的 Android SDK 平台工具,可以通过 Android Studio 或从 Google 开发者网站下载独立软件包来获取。该软件包内包含您将在控制台中使用的 adb 二进制文件。如果您使用的是 macOS,请参阅相关指南。 将您的安卓设备与Mac无缝连接。.
另一个必要条件是: 电脑和手机连接到同一个Wi-Fi网络不要将电脑通过以太网连接到公司网络,而将手机连接到访客 Wi-Fi,因为在这种情况下,它们通常无法互相看到,或者会有过滤器阻止 p2p 流量。
最后,您必须激活 在 Android 设备上找到“开发者选项”,并在其中找到“无线调试”功能。如果没有这个设置,手机将无法通过 Wi-Fi 接受任何 ADB 连接。另外,当您看到设备想要通过特定网络进行调试的通知时,如果您计划经常使用该网络,请勾选“始终允许”复选框。
启用开发者选项和无线调试

忘记电缆的第一步就是把它弄走。 Android 应该显示高级开发者选项,并明确允许通过 Wi-Fi 使用 ADB。尽管菜单名称略有不同,但几乎所有自定义层的操作过程都非常相似。
要启用开发者选项,请转到 设置 > 关于手机(或设备信息),然后反复点击“版本号”或“版本号”。轻点几下后,系统会显示类似“您现在是开发者”或“无需注册,您已经是程序员”的消息。从那时起,设置中将出现一个新的“开发者选项”菜单。
最快捷的方法是使用手机设置中内置的搜索功能,然后输入 点击“开发者选项”即可直接进入高级设置部分里面有调试开关,包括 USB 和无线两种模式。
滚动列表,直到看到该条目。 无线调试或通过 WLAN 进行调试启用此功能后,Android 系统会弹出一个窗口,显示您连接的 Wi-Fi 网络参数并要求您确认。请勾选该复选框。 始终允许此网络 如果您信任它,请按“允许”。
在无线调试开关旁边,通常有一个指向右侧的箭头;点击它即可访问…… 专用的无线调试屏幕,您可以在其中看到诸如使用二维码连接设备、使用同步码配对或使用配对码连接等选项。接下来我们将实现手机与电脑的无线连接。
使用 Android Studio 通过无线方式连接 ADB(二维码或 PIN 码)

如果您已经在使用 Android Studio 进行开发,那就非常简单,因为最新版本的 IDE(从 Android Studio Bumblebee 开始)都包含此功能。 一款图形化助手,用于通过 Wi-Fi 使用二维码或数字码配对物理设备。你几乎不需要输入任何命令。
项目打开后,打开 Android Studio。 打开设备管理器,然后点击“物理设备”选项卡查看您的物理设备。根据版本不同,顶部会显示“使用 Wi-Fi 配对”或“使用 Wi-Fi 配对设备”选项。
点击该选项会弹出一个包含两个标签页的窗口: 使用二维码配对和使用配对码配对默认标签页通常是二维码标签页,其中已经显示了一个可供扫描的二维码。
那个二维码不是什么黑魔法: Android Studio 内部会生成 Wi-Fi 连接配置文件和配对数据,这些数据会被编码到二维码中。如果你用其他读取器扫描它,你会发现这是一个特定的配置,但是你不应该使用第三方读取器连接手机;扫描必须从 Android 本身的无线调试菜单中进行。
在手机上,启用开发者选项,然后转到 进行无线调试,然后点击“使用二维码配对设备”。这将以扫描模式打开相机。将相机对准 Android Studio 在电脑上显示的二维码,等待几秒钟,直到配对过程完成。
如果一切顺利, 移动设备将与您的工作站配对,无需您输入任何命令。Android 会将该设备记住为已链接设备,并且在 Android Studio 中,该手机将出现在可运行和调试应用程序的物理设备列表中。
二维码配对可能失败或卡在“正在配对设备……”的界面。在这种情况下,我们将切换到另一个标签页: 使用配对码进行配对,配对码是一个六位数的数字代码,用于完成同步。当网络出现问题或二维码阅读器出现故障时,这种方法通常更可靠。
使用同步码(无需二维码)配对无线ADB
当二维码阅读器出现故障时,备用方案包括: 使用六位数的配对码以及 IP 地址和端口号。Android 会在无线调试屏幕上显示该信息。
在手机上,返回“设置”>“开发者选项”>“无线调试”,然后点击该选项。 使用同步码连接或使用配对码配对设备屏幕上会弹出一个窗口,其中包含类似“192.168.XY:PORT”的字段以及一个六位数的数字代码。此信息属于敏感信息,最好不要与任何人分享。
在移动设备上保持此屏幕打开,切换到电脑,在 Android Studio 的 Wi-Fi 配对向导中,选择该选项卡。 使用配对码进行配对,然后按下配对按钮输入配对码。Android Studio 将开始搜索等待配对的设备。
检测到手机后,助手会询问您…… 在 Android Studio 中输入您在 Android 屏幕上看到的六位代码。确认后,配对完成,设备即可进行无线安装和调试。
配对成功后,即可打开标签页 在 Android Studio 中使用终端,像使用普通控制台一样启动 adb 命令。唯一的区别是,如果您没有将 platform-tools 添加到 PATH 环境变量中,则必须手动导航到 adb 二进制文件所在的文件夹(例如,在 Windows 上为 %LOCALAPPDATA%\Android\SDK\platform-tools)。
请记住,即使配对关系持续存在, 如果设备更换 Wi-Fi 网络、失去信号或路由器阻止 P2P 连接,无线连接可能会中断。在这种情况下,只需从 Android Studio 重新连接设备,或者如果设备已忘记配对,则重新执行配对过程即可。
无需 Android Studio 即可使用 ADB:命令行和手动配对
如果您更喜欢直接使用终端,或者您的电脑无法流畅运行 Android Studio,您也可以…… 使用 `adb pair` 和 `adb connect` 直接从命令行使用 Android 11+ 的无线调试功能。它非常适合 Windows、macOS 或 Linux 系统,无需集成开发环境 (IDE)。
在移动设备上启用无线调试后,进入相同的菜单并点击 链接设备与同步代码你会看到IP地址、配对端口以及著名的六位数代码。不要关闭屏幕显示。
在你的电脑上,打开终端并导航到 adb 所在的文件夹,通常 Windows 系统下,路径为 android_sdk/platform-tools 或 C:\Users\YOUR_USER\AppData\Local\Android\Sdk\platform-tools。如果您不想每次都输入该路径,可以稍后将其添加到系统的 Path 变量中。
现在在控制台中运行以下命令。 adb 对 ip:port将 ip:port 替换为您手机上显示的地址,例如 adb pair 192.168.1.23:37119。然后,程序会要求您输入六位数的配对码。
如果代码正确且网络配置正确, 设备将完成配对,但还缺少一样东西:用于安装和调试应用程序的实际 ADB 连接。在同一个 Android 无线调试屏幕上,靠近顶部的位置,您会看到另一个与您的设备名称关联的 IP 地址:端口。
第二个IP地址和端口号是关键: 您必须使用命令 `adb connect ip:port` 来建立活动的 ADB 连接。例如,adb connect 192.168.1.23:5555。如果一切正常,该设备将在 adb 设备列表中显示为“device”。
每次你想从头开始重新连接时,如果都必须这样做,也不要感到惊讶。 重复配对代码的过程,然后使用新的 IP 地址和端口号执行 adb connect 操作。在许多情况下,即使 Android 显示计算机已配对,也建议重复代码生成步骤,以避免 mDNS 发现错误。
在 Windows 中配置 ADB 路径以便于使用
如果必须使用 ADB,那么操作起来就会变得很麻烦。 每次打开命令提示符时,都要输入 platform-tools 的完整路径或使用 cd 命令进入该文件夹。理想的解决方案是将该文件夹添加到 Windows Path 环境变量中。
在 Windows 10 或 11 中,使用“开始”菜单搜索来访问 “编辑系统环境变量”或“编辑帐户环境变量”将打开一个窗口,其中包含两个部分:用户变量和系统变量。
在顶部“用户变量”下方,选择 选择“路径”,然后按“编辑”>“新建”添加一个条目,其中包含平台工具文件夹的完整路径。例如,C:\Users\你的用户名\AppData\Local\Android\Sdk\platform-tools。接受所有对话框以保存更改。
从那一刻起,如果您打开一个新的命令提示符或 PowerShell 窗口,您将能够 无需指定文件夹,即可从任意路径运行 adb 命令当您编写脚本或将 adb 与其他工具结合使用时,这尤其方便。
为了验证一切是否正确,只需键入 使用 adb devices 命令验证系统是否识别该二进制文件并列出已连接的设备。 (可通过 USB 或 Wi-Fi 连接)。如果出现“无法识别的命令”错误,请检查路径拼写是否正确,以及更改路径后是否打开了新的控制台窗口。
传统方法:先通过 USB 连接,然后通过 Wi-Fi 使用 ADB(Android 10 及更早版本)
虽然 Android 11 及更高版本有自己的无线配对系统, 通过 TCP/IP 协议在 5555 端口启用 ADB 的老方法仍然完全有效。它是 Android 10 及更早版本中唯一的纯 Wi-Fi 选项,如果您喜欢这种方式,它也适用于 Android 11 及更高版本。
操作步骤很简单:首先,确保 电脑和手机共用同一个Wi-Fi网络,并通过USB数据线将手机连接到电脑。在开发者选项中启用 USB 调试,并在对话框出现时接受计算机的 RSA 密钥。
从您的计算机终端,使用 运行 `adb devices` 来验证设备是否显示为“device”,以及 USB 连接是否正常工作。如果未列出或显示为离线状态,则需要检查驱动程序、电缆或端口。
当手机响应正常时,执行该命令 `adb tcpip 5555` 命令告诉 adbd 开始监听端口 5555 上的 TCP 连接。如果命令执行成功,现在可以断开手机上的 USB 连接线。
在手机上,依次进入“设置”>“关于手机”>“状态”>“IP地址”(或具体的Wi-Fi设置部分),并记下该地址。 设备的内部 IP 地址,格式为 192.168.xx接下来,在计算机控制台中,使用 adb connect ip_address:5555,例如 adb connect 192.168.1.50:5555。
如果一切正确, `adb devices` 现在会将 IP 地址:5555 显示为“设备”,即使在较旧版本的 Android 上,您也可以通过 Wi-Fi 激活 ADB。不过请记住,如果您更换网络或重启手机,您可能需要重新进行 USB + TCP/IP 连接过程。
使用 Termux 和 Tasker 在移动设备上通过 Wi-Fi 自动执行 ADB 操作
对于想要更进一步的高级用户,可以选择…… 使用 Termux 和 Tasker,即可直接从手机通过 Wi-Fi 自动激活 ADB。这样,每次手机启动时,无线调试服务器都会被激活。
总体思路是安装 Termux(最好从 F-Droid 下载,因为它有最新的软件源)、Termux:Tasker 插件和 Tasker 应用在 Termux 中,使用 pkg install android-tools 添加 android-tools 软件包,以便在手机本身上使用 adb 二进制文件。
然后,在 Termux 中创建文件夹结构。 在 .termux/tasker 目录下,你可以编写类似 adb.sh 和 adb_pair.sh 的脚本。它接受主机和代码参数,并直接在 Termux 环境中执行 adb connect、adb tcpip 5555、adb pair 或 adb kill-server 等命令。
在安卓系统上,Tasker 需要被授予以下特殊权限: “在 Termux 环境中执行命令”,以便在满足特定条件时启动这些脚本。完成后,Tasker 配置文件将被导入,以便在手机解锁时激活 Wi-Fi ADB,通过 Logcat 日志获取调试端口,并自动连接。
典型概况包括: 设备启动时,它会初始化一个状态变量;启动一段时间后,它会初始化另一个状态变量以启用 WLAN 调试;第三个状态变量则会分析日志、提取端口,并调用 Termux 脚本连接并切换到 TCP/IP 5555 端口。虽然对于大多数人来说,这更多的是一种极客式的解决方案,而不是实用的解决方案,但它展示了无线调试的潜力。
对于通过代码进行的初始配对,可以配置一个 Tasker 配置文件,当屏幕上出现“使用代码配对设备”窗口时,按住音量增大键, 自动将 IP 地址、端口和代码发送到 Termux,以便从手机本身运行 adb 对。配对成功后,该个人资料将被停用,因为不再需要不断重复输入。
通过 Wi-Fi 工作时常用的主要 ADB 命令
连接建立后,ADB 的全部功能即可使用,就像通过 USB 连接一样,所以最好清楚这一点。 以下是一些最常用的无线调试命令.
要查看哪些设备已连接,基本命令是 `adb devices -l` 会列出每个实例及其序列号、状态和简要描述。如果设备处于无线模式,通常会显示其 IP 地址:端口。
如果您同时拥有多个设备(包括物理设备或模拟器),您可以使用以下命令将命令定向到特定设备。 使用 adb -s serial_number 命令,或设置 ANDROID_SERIAL 环境变量。当每种类型只有一个设备时,还可以使用快捷方式 -d 表示“唯一的物理设备”,使用 -e 表示“唯一的模拟器”。
要通过 APK 文件安装应用程序,您将使用 adb install path_to_apk,如果是多个拆分的 APK,则使用 adb install-multiple。卸载时,`adb uninstall package.name` 会删除应用程序,使用 `-k` 选项可以保留用户数据。
关于文件操作,您有 使用 `adb push archivo_local ruta_remota` 命令将文件发送到移动设备,使用 `adb pull ruta_remota carpeta_local` 命令将文件拉取到计算机。结合屏幕截图或日志记录使用时非常有用。
要访问设备的系统,可以使用传统的方法。 adb shell,它会在移动设备上打开一个带有类 Unix 工具的交互式 shell。从那里,您可以启动 am(Activity Manager)来启动活动、服务或发送意图,以及启动 pm(Package Manager)来列出、启用或禁用软件包和权限。
高级功能:屏幕截图、屏幕录制和其他实用工具
ADB的功能不仅限于安装和卸载应用程序;它还能协助执行许多非常强大的支持任务, 当你无需通过数据线将手机连接到电脑即可使用它们时,它们就更有意义了。.
截屏的基本命令是 使用 adb shell screencap /sdcard/screen.png 命令,然后使用 adb pull /sdcard/screen.png 命令将截图传输到电脑。您还可以使用 `adb exec-out screencap -p > screen.png` 一次性将其直接保存到本地计算机。
如果你想录制视频,你有相应的工具。 `adb shell screenrecord /sdcard/demo.mp4`,默认情况下会将设备屏幕录制到 MP4 文件中,最长可达 3 分钟。完成后,您可以使用 `adb pull` 下载它。Screenrecord 允许您使用 `--size`、`--bit-rate` 或 `--time-limit` 等参数调整分辨率、比特率和最大录制时间。
另一个非常强大的功能是 使用 adb forward tcp:host_port tcp:device_port 或将端口转发到特定目标,例如 local:logd这对于调试内部移动服务、测试本地 API 或检查流量非常有用。
如果 ADB 在任何时候开始出现异常行为、无响应或停止识别设备,您可以 使用 `adb kill-server` 命令重启服务器,然后在执行任何 adb 命令时隐式地重新启动它。这样可以解决很多具体问题,而无需触及其他任何方面。
最后,对于非常密集的开发项目,您可能对以下内容感兴趣: ADB 36.0.0 的突发模式可通过环境变量 ADB_BURST_MODE=1 或在 Android Studio 设置中激活。它提高了大容量传输的性能,并通过允许 ADB 发送数据包而无需等待每个响应太长时间来降低延迟。
Android 11 及更高版本内置的无线调试功能、通过二维码或 PIN 码配对、经典的 TCP/IP 方法,以及该工具本身提供的所有命令和实用程序, 如今,您可以非常灵活地通过电脑操作 Android 设备,最重要的是,无需依赖总是在您最不需要的时候出现的连接线。.