做移动端测试和开发的人应该都经历过这种场景电脑和手机之间来回插拔USB线充着电还得担心数据口松动。尤其是做自动化测试、频繁装机、抓日志的时候一根线的存在感能强到让你怀疑人生。WiFi ADB这个功能就是干这个用的它在Android 13上比早期版本更稳定但很多人卡在“手动开启太麻烦”这一步或者压根不知道这功能还能自动化每次要么翻设置要么干脆放弃无线调试。这篇文章就围绕“Android 13设置自动进入WiFi ADB模式”这件事把原理、手动流程、自动化脚本、常见坑全部拆开讲清楚适合Android开发、测试工程师、搞自动化脚本的朋友也适合喜欢折腾手机设备的高级玩家直接照着抄作业。1. 为什么要“自动”进入WiFi ADB开发场景里的真实需求1.1 每次插拔USB线的效率损耗比你想象中更夸张开发或者测试过程中USB线的作用不只是充电和传输数据它还是ADB调试的物理通道。我见过不少项目组测试机一放就是一排每台手机都要用线连着电脑桌面乱成一团不说经常出现“设备列表里找不到设备”“驱动掉了”“接触不良导致刷机失败”这类问题。如果是做长时间跑测的场景比如Monkey测试、App遍历测试、性能采集USB线稍微松动一下整个会话就断了日志半途而废又得从头再来。WiFi ADB的本质就是把ADB的传输通道从USB线换成局域网无线网络。手机和电脑处于同一个WiFi环境下就能像插着线一样执行adb命令、安装APK、抓取日志、操作UI。对于真机调试来说这相当于把“物理束缚”解开你可以在办公室任何一个角落发起调试也不用担心数据线坏了、接口松了、线不够长这些破事。而标题里强调的“自动进入”解决的是开启这一步的繁琐问题——如果每次都要去开发者选项里手动开关、看端口号、输命令那无线调试带来的便利性会被大打折扣。1.2 “手动”和“自动”之间差的是一整套执行链路手动开启WiFi ADB的流程在Android 13上可以拆成四步进入开发者选项、打开无线调试开关、点开“使用配对码配对设备”、在电脑上执行adb pair命令完成配对最后再通过adb connect建立连接。每一步单独看都不难但组合起来就麻烦了。尤其是配对端口和连接端口都是动态生成的每次连接新WiFi或者设备重启之后端口号可能会变你需要重新看一眼屏幕再敲一次命令。所谓“自动进入”我的理解是两部分第一把重复的手工操作变成一条或几条命令第二把“改端口、改IP”这种动态变化的部分通过脚本自动探测和处理真正做到插上线或者执行一次脚本就能进入无线调试状态。后面所有方案都围绕这两个目标展开。理解了这一点你就能明白为什么有人愿意花时间折腾这个功能——省下来的不是那几分钟而是整个调试节奏的流畅度。1.3 这篇文章适合谁读完能解决什么问题如果你正在用Android Studio开发原生App每天跟真机打交道或者你负责设备的批量管理和自动化测试又或者你只是有一台不常用的备用机想摆脱数据线这篇文章都适合你。读完你会知道Android 13的无线调试到底怎么工作、为什么端口会变、怎么用一条脚本完成自动配对和连接、遇到连不上或者反复掉线该怎么查。我尽量不给那种复制粘贴就跑不通的“假代码”所有命令和思路都是实测过的常见做法你照着调整一下IP和端口就能用。2. WiFi ADB的核心原理与Android 13的变化2.1 从ADB到ADB over TCP/IP一条命令背后的传输机制ADBAndroid Debug Bridge是Android调试的总入口它由三部分组成电脑端的adb client、手机端后台的adbd服务、以及连接二者的通信通道。传统方式下这个通道走的是USB系统通过USB的端点把adb协议数据封装并传输。换成WiFi调试之后通道变成了网络Socket本质上是adb client通过TCP协议连到手机adbd监听的端口上数据照样走只是物理介质从USB线换成了无线网卡。要让adbd监听网络端口Android早期版本提供的命令就是adb tcpip 5555。执行这个命令后adbd会自己起一个TCP监听默认端口是5555之后你只要知道手机的IP地址就能通过adb connect 手机IP:5555连进去。这里有个容易被忽略的细节执行tcpip命令时手机必须还是USB连接状态因为这条命令本身需要通过ADB通道传给adbd然后adbd才会把监听端口打开。如果你已经断了线这条命令就无从执行了。2.2 Android 11之后的“无线调试”和Android 13的端口分配逻辑从Android 11开始系统设置里多了一个专门的“无线调试”选项它和旧版adb tcpip最大的区别在于不再固定使用5555端口而是由系统在每次启动无线调试时随机分配一个高位数端口。配对时还会再分配一个配对端口。如果你在Android 13的设备上打开无线调试面板能看到两行关键信息一行是“IP地址和端口”用于最终连接一行是“配对码和配对端口”用于首次配对。Android 13在这套机制上做了一些稳定性优化。比如系统会自动记住已经配对过的网络同一WiFi下重新开启无线调试时配对关系能保留不需要每次都重新配对。另外Android 13对mDNS服务发现的支持也更完善电脑端在执行adb mdns services时能快速发现局域网内处于无线调试状态的设备。这给自动化带来很大便利因为脚本可以不用手动解析端口号直接通过mDNS拿到当前设备的连接端口。2.3 传统tcpip 5555方案在Android 13上还能用吗这个问题我实测过答案是可以但有条件。在Android 13设备上如果你通过USB连接后执行adb tcpip 5555手机会开启5555端口的ADB监听之后用adb connect 手机IP:5555依然能连上。但有一点要注意如果设置里的“无线调试”开关也被打开了两者可能会互相干扰偶尔出现端口冲突或连接不稳定。我的建议是做自动化脚本时优先使用系统自带的无线调试功能因为它的端口管理更规范而且能配合adb pair做安全管理只有遇到特殊设备或者定制ROM才退回到tcpip 5555方案。从安全角度看Android 13的无线调试也比早期的直接开放5555要严谨得多。首次连接必须通过6位配对码验证设备屏幕上会显示一个一次性的配对码电脑端必须验证通过才能建立配对关系。这样一来局域网里其他人即使扫描到了你的设备没有配对码也无法直接连接调试接口。自动化的难点也恰恰在这里配对码是动态的每次配对都需要肉眼读取并输入并不能像tcpip方案那样完全免交互。后面我会讲怎么在这个前提下尽量压缩手动操作的环节。3. Android 13下手动开通WiFi ADB的完整流程3.1 打开开发者选项与无线调试面板手动流程虽然繁琐但它是自动化方案的基础必须先搞清楚每一步的作用。首先要保证手机已开启开发者选项一般在“设置-关于手机”里连续点击版本号七次就能解锁开发者模式。然后进入“设置-系统-开发者选项”往下翻找到“无线调试”把开关打开。这一步之后系统会提示你“在此网络上的配对设备可以连接到此设备”这就是无线调试的守护进程在后台跑起来了。打开无线调试开关后你会看到这个面板里列出当前设备的IP地址和连接端口格式类似192.168.1.100:39453。注意这个端口是随机生成的重启或者切换WiFi后可能变化。如果你点了“使用配对码配对设备”屏幕上会弹出一个对话框里面显示配对用的IP和端口、6位配对码。配对端口和连接端口不是同一个很多人第一次操作就在这里搞混拿配对端口去执行connect结果一直超时。3.2 执行pair配对然后connect建立连接配对的命令全称是adb pair后面跟上设备屏幕上显示的配对IP和端口然后在提示符里输入6位配对码。以我的测试机为例如果屏幕上显示配对端口是192.168.1.100:40123配对码是831204那么电脑端执行的命令就是adb pair 192.168.1.100:40123执行后adb会提示你输入配对码输入831204回车几秒钟后会显示配对成功。这一步完成后无线调试面板里就会多出一台已配对的设备记录而且Android 13会记住这个配对状态不需要每次都用配对码重新验证。接下来执行连接命令这时要用连接端口而不是配对端口。假如连接端口是39453就执行adb connect 192.168.1.100:39453返回connected to 192.168.1.100:39453就说明已经建立了无线连接。你可以用adb devices查看当前设备列表如果看到192.168.1.100:39453 device而不是offline说明无线调试真的生效了后面所有adb操作都和插着USB线一样。3.3 用命令快速验证连接状态与调试能力有几种验证方式可以快速确认连接有效性。第一种就是上面说的adb devices简单直接。第二种是用adb -s 192.168.1.100:39453 shell getprop ro.build.version.release能正常返回Android版本号说明命令通道是通的。如果你要同时管理多台设备建议每次操作都加上-s指定序列号避免adb不知道往哪台设备发命令。我还习惯在连接完成后跑一下adb shell wm size或者adb shell ip addr show wlan0确认网络状态和屏幕参数都正常。如果这些命令都能快速返回结果基本可以确定无线调试链路稳定可以开工干活了。我在实际项目中会把这一步封装成一个环境检查脚本每次跑自动化测试之前先自动验证连接状态省去手动一条条敲命令的麻烦。4. 自动进入WiFi ADB的三种落地实现4.1 方案一USB触发脚本一次按键完成切换这套方案适合那些“设备平时要插着USB充电又要频繁做无线调试”的场景。思路是用USB把手机和电脑连上运行一个脚本脚本自动完成“获取设备IP、设置tcpip或读取无线调试端口、建立无线连接”的全流程。我常用的是一个bash脚本核心逻辑如下#!/usr/bin/env bash ADBadb TCP_PORT5555 echo [1/4] 等待USB设备接入... $ADB wait-for-device sleep 2 echo [2/4] 获取设备IP地址... DEVICE_IP$($ADB shell ip route | awk {print $9; exit}) if [ -z $DEVICE_IP ]; then echo 错误获取IP失败请确认设备已连接WiFi exit 1 fi echo 设备IP: $DEVICE_IP echo [3/4] 开启TCP/IP调试端口... $ADB tcpip $TCP_PORT sleep 3 echo [4/4] 建立无线连接... $ADB connect ${DEVICE_IP}:${TCP_PORT} echo 完成当前设备列表 $ADB devices脚本执行完毕后手机可以拔掉USB线所有adb操作转到无线通道上继续执行。这个方案的关键点是ip route命令能拿到设备的WiFi网段IP如果设备同时插着USB和开着热点可能会有多张网卡建议进一步判断wlan0接口的IP以免拿错地址。另外tcpip命令切换后要等几秒再connect给adbd一点重启监听端口的时间。如果你用的是Android 11以上的系统且已经手动配对过也可以把tcpip切换改成直接s参数连接无线调试面板上显示的端口。但那种方式需要提前知道动态端口对脚本来说不够通用所以我更建议在自动化脚本里同时尝试两种方式先检查adb mdns services里有没有_adb-tls-connect._tcp的服务有就直接用发现的端口连接没有就退回到tcpip 5555思路。4.2 方案二利用mDNS自动发现设备免去手动输端口Android 11之后的无线调试设备会在局域网里广播mDNS服务服务类型包括_adb-tls-connect._tcp和_adb-tls-pairing._tcp。这就意味着只要手机端的无线调试开关是开的同一网段的电脑理论上能通过mDNS直接发现它不需要去看设置界面里的端口号。这对自动化脚本来说太重要了。在命令行里执行adb mdns services会输出当前局域网发现到的ADB mDNS服务例如adb mdns services List of discovered mdns services: _adb-tls-connect._tcp 192.168.1.100:37465 Pixel 6 _adb-tls-pairing._tcp 192.168.1.100:39123 Pixel 6可以看到connect服务和pairing服务的端口是分开的。脚本可以解析connect服务的端口然后直接adb connect。这样做完全不需要人眼读取端口唯一的条件是手机已经处于无线调试开启状态最好已经配对过。结合mDNS做自动连接的脚本大致是这样的思路# 用mdns服务发现拿到连接端口 PORT$(adb mdns services | grep _adb-tls-connect._tcp | head -n1 | awk -F[: ] {print $3}) IP$(adb mdns services | grep _adb-tls-connect._tcp | head -n1 | awk {print $3} | cut -d: -f1) adb connect ${IP}:${PORT}要注意的是adb mdns services的输出格式在不同平台、不同adb版本下会略有差异有的版本会带制表符有的用空格。我建议在脚本里用正则提取数字端口宁可多写两行解析也别写死格式。另外如果电脑和手机不在同一个网段或者路由器开了AP隔离mDNS广播是传不过来的这种网络环境下mDNS方案不可用需要退回USB触发方案。4.3 方案三Android Studio里集成无线调试任务适合日常开发如果你主要的场景是开发调试不想来回切窗口敲命令可以在Android Studio里把无线调试做成一个External Tool或者一个Task配置。这样每次点一下菜单就能自动完成设备发现和连接。我常用的做法是配置一个Shell脚本作为External Tools入口脚本里封装前面提到的mDNS自动发现逻辑然后在Android Studio的菜单栏里直接触发。具体配置步骤不复杂打开Android Studio的Settings找到Tools - External Tools点加号。Name填WiFi ADB ConnectProgram填/bin/bash或你脚本的绝对路径Arguments填脚本路径Working directory填项目目录。保存后菜单栏Tools下就会多出一个WiFi ADB Connect入口点击后底部Run窗口直接输出连接结果。这个方案让我在实际开发里节省了大量时间尤其是手头两台测试机来回切着调试的时候点一下菜单就跟切换数据线一样方便。而且Android Studio的Run窗口会保留脚本输出连接是否成功、端口是什么一眼就能看到比在终端里翻历史记录清晰得多。如果你更习惯IDEA风格的开发工具也可以用类似方式配置原理完全一样。4.4 方案四设备端自动化用Tasker等工具实现全自动开启以上三种方案都依赖电脑端操作手机还是要先手动开一下无线调试开关。如果你连这一步都想省那就要引入设备端自动化工具了比如Tasker、MacroDroid这类能触发系统动作的App。它们可以在特定条件下自动打开无线调试设置页甚至通过模拟点击的方式把配对开关打开。这里要强调一点普通非root设备是无法直接通过系统API打开无线调试开关的因为这是受保护设置项。Tasker能做的只是把“设置-开发者选项-无线调试”这个页面调出来然后通过系统辅助功能模拟点击把开关打开。如果你需要全自动还得结合电脑端的adb自动发现形成一套“触发即连”的完整链路。实际使用中我一般把Tasker的触发条件设置成连接指定WiFi时自动打开无线调试页面。这样到了公司手机连上办公室WiFi它会自动把无线调试准备好电脑端再用脚本一键连接两边都不用管设置页面。这个方案适合那些固定工位、固定WiFi的办公环境频繁更换网络的场景不太推荐因为每个新WiFi网络安全策略不同可能存在连接限制。5. WiFi ADB实战中的踩坑与排查技巧5.1 常见连接问题速查表不管哪种方案WiFi ADB最让人头疼的都是连接不稳定、连不上、掉线这老三样。我把实战中遇到频率最高的问题整理成了表格可以直接对照排查。现象常见原因排查方向adb pair提示超时或失败配对端口写错、手机屏幕配对码已过期重新点击“使用配对码配对设备”确认端口和配对码是当前显示的值adb connect一直卡在connecting连接端口和配对端口混用确认连接用的是“IP地址和端口”里的端口不是配对端口连接成功但adb devices显示offline设备授权弹窗未确认或者USB模式异常查看手机是否弹出“允许USB调试”提示重新插拔USB后执行adb usb恢复USB模式再试无线连接频繁断开网络信号弱、手机锁屏后WiFi休眠、路由器AP隔离在开发者选项里打开“保持唤醒状态”锁屏调试时考虑关闭WiFi休眠策略脚本里adb mdns services输出为空手机无线调试未开启、不在同一网段、路由器不支持mDNS确认手机上无线调试开关是开着的电脑和手机连同一个WiFi热点多台设备时连错设备设备IP变化、端口重复每次操作都用adb -s指定具体序列号不要依赖默认设备tcpip 5555方式在Android 13上偶发端口冲突与系统无线调试开关同时开启关闭系统自带无线调试只保留tcpip方式或者反过来只用系统无线调试排查思路上建议第一个动作永远是看状态。手机端确认无线调试开关是否还开着面板上的IP和端口是否变化了电脑端执行adb devices看看当前设备列表状态。这两步能定位80%的问题。5.2 稳定性优化让无线调试在长时间任务中不掉链子WiFi ADB在Android 13上已经比早期版本稳了很多但长时间跑自动化测试时我还踩过几个坑。首先是手机锁屏问题默认情况下手机息屏一段时间后WiFi模块可能进入低功耗模式导致ADB连接直接断掉。解决方法是开发者选项里的“充电时保持唤醒状态”打开或者直接把锁屏时间调长如果是root设备还可以通过adb shell svc power stayon true设置充电不休眠。其次是网络环境的影响。办公WiFi如果开了AP隔离设备之间是无法直接互访的WiFi ADB在这种网络下基本用不了。我建议搭建无线调试环境时首选手机开热点让电脑连热点或者用一台单独的随身路由把设备都挂在同一个AP下这样网络层的问题最少。还有一个容易忽略的点电脑端的防火墙。Windows自带的防火墙有时会把adb的连接端口拦截掉尤其是第一次运行时弹窗询问是否允许adb通过防火墙如果你手快点掉“取消”后面所有无线连接都会失败。遇到这种问题直接去防火墙设置里手动放行adb.exe或者干脆把当前网络配置文件改成“专用网络”很多奇怪的连接失败就解决了。5.3 安全提醒无线调试虽然方便但别在公共场合裸奔无线调试本质上是开放了一个网络调试端口虽然Android 13有配对码验证但一旦配对完成后端口依然暴露在局域网里。如果公司或公共场所的WiFi不可信或者说你和别人共享同一个WiFi对方技术够好的话存在被连接调试的风险。所以我的建议是公共网络环境下不要开无线调试不用的时候果断关掉开关或者至少在开发者选项里把“网络审计日志”打开对异常连接保持敏感。另外要提醒的是adb tcpip 5555这种传统方式的端口是固定且没有配对码机制的安全性比系统无线调试差得多。我在公司内网测试机上用过一段时间后来统一改成系统无线调试了就是为了减少暴露面。如果你只是自己家用或者纯本地调试问题不大但涉及公司设备或者公网环境至少要把端口访问和网络策略收紧。6. 从手动到自动的完整链路我目前最推荐的使用姿势综合对比下来我目前最顺手的组合是设备端开无线调试开关电脑端mDNS自动发现脚本Android Studio外部工具入口。具体分工是手机连上公司WiFi后手动打开无线调试这步暂时没法完全省除非你用Tasker自动点击电脑端运行一个一键脚本脚本先尝试adb mdns services自动发现设备拿到连接端口后直接adb connect再把脚本挂到Android Studio的External Tools里日常开发点一下菜单就能连上完全不用打开终端。这套组合的优势在于mDNS方式把最大的不确定性即动态端口解决掉了不需要每次查看手机屏幕。而USB触发脚本作为备用方案解决的是无线调试还没开启、或者mDNS被网络禁掉的情况。两条路互补基本覆盖了我在开发、测试、自动化脚本运行的所有场景。我在真实项目中已经跑了半年多每天至少重复连接手机五六次体验比之前插拔USB线舒服太多。唯一需要适应的就是偶尔网络波动导致的掉线重连一下脚本就好。如果你也在被数据线折磨强烈建议把这套流程搭起来省下来的时间用来多看两页文档都值了。最后分享一个小习惯我会在脚本里加上一个adb disconnect的收尾操作每次跑完自动化用例后主动断开无线连接避免端口一直被占用。下一次再用脚本连接速度更快也不容易出杂七杂八的网络冲突。这个细节不起眼但在长期反复连接的使用场景里真的能少踩很多坑。
Android 13 WiFi ADB自动化连接：原理、脚本与实战避坑指南
做移动端测试和开发的人应该都经历过这种场景电脑和手机之间来回插拔USB线充着电还得担心数据口松动。尤其是做自动化测试、频繁装机、抓日志的时候一根线的存在感能强到让你怀疑人生。WiFi ADB这个功能就是干这个用的它在Android 13上比早期版本更稳定但很多人卡在“手动开启太麻烦”这一步或者压根不知道这功能还能自动化每次要么翻设置要么干脆放弃无线调试。这篇文章就围绕“Android 13设置自动进入WiFi ADB模式”这件事把原理、手动流程、自动化脚本、常见坑全部拆开讲清楚适合Android开发、测试工程师、搞自动化脚本的朋友也适合喜欢折腾手机设备的高级玩家直接照着抄作业。1. 为什么要“自动”进入WiFi ADB开发场景里的真实需求1.1 每次插拔USB线的效率损耗比你想象中更夸张开发或者测试过程中USB线的作用不只是充电和传输数据它还是ADB调试的物理通道。我见过不少项目组测试机一放就是一排每台手机都要用线连着电脑桌面乱成一团不说经常出现“设备列表里找不到设备”“驱动掉了”“接触不良导致刷机失败”这类问题。如果是做长时间跑测的场景比如Monkey测试、App遍历测试、性能采集USB线稍微松动一下整个会话就断了日志半途而废又得从头再来。WiFi ADB的本质就是把ADB的传输通道从USB线换成局域网无线网络。手机和电脑处于同一个WiFi环境下就能像插着线一样执行adb命令、安装APK、抓取日志、操作UI。对于真机调试来说这相当于把“物理束缚”解开你可以在办公室任何一个角落发起调试也不用担心数据线坏了、接口松了、线不够长这些破事。而标题里强调的“自动进入”解决的是开启这一步的繁琐问题——如果每次都要去开发者选项里手动开关、看端口号、输命令那无线调试带来的便利性会被大打折扣。1.2 “手动”和“自动”之间差的是一整套执行链路手动开启WiFi ADB的流程在Android 13上可以拆成四步进入开发者选项、打开无线调试开关、点开“使用配对码配对设备”、在电脑上执行adb pair命令完成配对最后再通过adb connect建立连接。每一步单独看都不难但组合起来就麻烦了。尤其是配对端口和连接端口都是动态生成的每次连接新WiFi或者设备重启之后端口号可能会变你需要重新看一眼屏幕再敲一次命令。所谓“自动进入”我的理解是两部分第一把重复的手工操作变成一条或几条命令第二把“改端口、改IP”这种动态变化的部分通过脚本自动探测和处理真正做到插上线或者执行一次脚本就能进入无线调试状态。后面所有方案都围绕这两个目标展开。理解了这一点你就能明白为什么有人愿意花时间折腾这个功能——省下来的不是那几分钟而是整个调试节奏的流畅度。1.3 这篇文章适合谁读完能解决什么问题如果你正在用Android Studio开发原生App每天跟真机打交道或者你负责设备的批量管理和自动化测试又或者你只是有一台不常用的备用机想摆脱数据线这篇文章都适合你。读完你会知道Android 13的无线调试到底怎么工作、为什么端口会变、怎么用一条脚本完成自动配对和连接、遇到连不上或者反复掉线该怎么查。我尽量不给那种复制粘贴就跑不通的“假代码”所有命令和思路都是实测过的常见做法你照着调整一下IP和端口就能用。2. WiFi ADB的核心原理与Android 13的变化2.1 从ADB到ADB over TCP/IP一条命令背后的传输机制ADBAndroid Debug Bridge是Android调试的总入口它由三部分组成电脑端的adb client、手机端后台的adbd服务、以及连接二者的通信通道。传统方式下这个通道走的是USB系统通过USB的端点把adb协议数据封装并传输。换成WiFi调试之后通道变成了网络Socket本质上是adb client通过TCP协议连到手机adbd监听的端口上数据照样走只是物理介质从USB线换成了无线网卡。要让adbd监听网络端口Android早期版本提供的命令就是adb tcpip 5555。执行这个命令后adbd会自己起一个TCP监听默认端口是5555之后你只要知道手机的IP地址就能通过adb connect 手机IP:5555连进去。这里有个容易被忽略的细节执行tcpip命令时手机必须还是USB连接状态因为这条命令本身需要通过ADB通道传给adbd然后adbd才会把监听端口打开。如果你已经断了线这条命令就无从执行了。2.2 Android 11之后的“无线调试”和Android 13的端口分配逻辑从Android 11开始系统设置里多了一个专门的“无线调试”选项它和旧版adb tcpip最大的区别在于不再固定使用5555端口而是由系统在每次启动无线调试时随机分配一个高位数端口。配对时还会再分配一个配对端口。如果你在Android 13的设备上打开无线调试面板能看到两行关键信息一行是“IP地址和端口”用于最终连接一行是“配对码和配对端口”用于首次配对。Android 13在这套机制上做了一些稳定性优化。比如系统会自动记住已经配对过的网络同一WiFi下重新开启无线调试时配对关系能保留不需要每次都重新配对。另外Android 13对mDNS服务发现的支持也更完善电脑端在执行adb mdns services时能快速发现局域网内处于无线调试状态的设备。这给自动化带来很大便利因为脚本可以不用手动解析端口号直接通过mDNS拿到当前设备的连接端口。2.3 传统tcpip 5555方案在Android 13上还能用吗这个问题我实测过答案是可以但有条件。在Android 13设备上如果你通过USB连接后执行adb tcpip 5555手机会开启5555端口的ADB监听之后用adb connect 手机IP:5555依然能连上。但有一点要注意如果设置里的“无线调试”开关也被打开了两者可能会互相干扰偶尔出现端口冲突或连接不稳定。我的建议是做自动化脚本时优先使用系统自带的无线调试功能因为它的端口管理更规范而且能配合adb pair做安全管理只有遇到特殊设备或者定制ROM才退回到tcpip 5555方案。从安全角度看Android 13的无线调试也比早期的直接开放5555要严谨得多。首次连接必须通过6位配对码验证设备屏幕上会显示一个一次性的配对码电脑端必须验证通过才能建立配对关系。这样一来局域网里其他人即使扫描到了你的设备没有配对码也无法直接连接调试接口。自动化的难点也恰恰在这里配对码是动态的每次配对都需要肉眼读取并输入并不能像tcpip方案那样完全免交互。后面我会讲怎么在这个前提下尽量压缩手动操作的环节。3. Android 13下手动开通WiFi ADB的完整流程3.1 打开开发者选项与无线调试面板手动流程虽然繁琐但它是自动化方案的基础必须先搞清楚每一步的作用。首先要保证手机已开启开发者选项一般在“设置-关于手机”里连续点击版本号七次就能解锁开发者模式。然后进入“设置-系统-开发者选项”往下翻找到“无线调试”把开关打开。这一步之后系统会提示你“在此网络上的配对设备可以连接到此设备”这就是无线调试的守护进程在后台跑起来了。打开无线调试开关后你会看到这个面板里列出当前设备的IP地址和连接端口格式类似192.168.1.100:39453。注意这个端口是随机生成的重启或者切换WiFi后可能变化。如果你点了“使用配对码配对设备”屏幕上会弹出一个对话框里面显示配对用的IP和端口、6位配对码。配对端口和连接端口不是同一个很多人第一次操作就在这里搞混拿配对端口去执行connect结果一直超时。3.2 执行pair配对然后connect建立连接配对的命令全称是adb pair后面跟上设备屏幕上显示的配对IP和端口然后在提示符里输入6位配对码。以我的测试机为例如果屏幕上显示配对端口是192.168.1.100:40123配对码是831204那么电脑端执行的命令就是adb pair 192.168.1.100:40123执行后adb会提示你输入配对码输入831204回车几秒钟后会显示配对成功。这一步完成后无线调试面板里就会多出一台已配对的设备记录而且Android 13会记住这个配对状态不需要每次都用配对码重新验证。接下来执行连接命令这时要用连接端口而不是配对端口。假如连接端口是39453就执行adb connect 192.168.1.100:39453返回connected to 192.168.1.100:39453就说明已经建立了无线连接。你可以用adb devices查看当前设备列表如果看到192.168.1.100:39453 device而不是offline说明无线调试真的生效了后面所有adb操作都和插着USB线一样。3.3 用命令快速验证连接状态与调试能力有几种验证方式可以快速确认连接有效性。第一种就是上面说的adb devices简单直接。第二种是用adb -s 192.168.1.100:39453 shell getprop ro.build.version.release能正常返回Android版本号说明命令通道是通的。如果你要同时管理多台设备建议每次操作都加上-s指定序列号避免adb不知道往哪台设备发命令。我还习惯在连接完成后跑一下adb shell wm size或者adb shell ip addr show wlan0确认网络状态和屏幕参数都正常。如果这些命令都能快速返回结果基本可以确定无线调试链路稳定可以开工干活了。我在实际项目中会把这一步封装成一个环境检查脚本每次跑自动化测试之前先自动验证连接状态省去手动一条条敲命令的麻烦。4. 自动进入WiFi ADB的三种落地实现4.1 方案一USB触发脚本一次按键完成切换这套方案适合那些“设备平时要插着USB充电又要频繁做无线调试”的场景。思路是用USB把手机和电脑连上运行一个脚本脚本自动完成“获取设备IP、设置tcpip或读取无线调试端口、建立无线连接”的全流程。我常用的是一个bash脚本核心逻辑如下#!/usr/bin/env bash ADBadb TCP_PORT5555 echo [1/4] 等待USB设备接入... $ADB wait-for-device sleep 2 echo [2/4] 获取设备IP地址... DEVICE_IP$($ADB shell ip route | awk {print $9; exit}) if [ -z $DEVICE_IP ]; then echo 错误获取IP失败请确认设备已连接WiFi exit 1 fi echo 设备IP: $DEVICE_IP echo [3/4] 开启TCP/IP调试端口... $ADB tcpip $TCP_PORT sleep 3 echo [4/4] 建立无线连接... $ADB connect ${DEVICE_IP}:${TCP_PORT} echo 完成当前设备列表 $ADB devices脚本执行完毕后手机可以拔掉USB线所有adb操作转到无线通道上继续执行。这个方案的关键点是ip route命令能拿到设备的WiFi网段IP如果设备同时插着USB和开着热点可能会有多张网卡建议进一步判断wlan0接口的IP以免拿错地址。另外tcpip命令切换后要等几秒再connect给adbd一点重启监听端口的时间。如果你用的是Android 11以上的系统且已经手动配对过也可以把tcpip切换改成直接s参数连接无线调试面板上显示的端口。但那种方式需要提前知道动态端口对脚本来说不够通用所以我更建议在自动化脚本里同时尝试两种方式先检查adb mdns services里有没有_adb-tls-connect._tcp的服务有就直接用发现的端口连接没有就退回到tcpip 5555思路。4.2 方案二利用mDNS自动发现设备免去手动输端口Android 11之后的无线调试设备会在局域网里广播mDNS服务服务类型包括_adb-tls-connect._tcp和_adb-tls-pairing._tcp。这就意味着只要手机端的无线调试开关是开的同一网段的电脑理论上能通过mDNS直接发现它不需要去看设置界面里的端口号。这对自动化脚本来说太重要了。在命令行里执行adb mdns services会输出当前局域网发现到的ADB mDNS服务例如adb mdns services List of discovered mdns services: _adb-tls-connect._tcp 192.168.1.100:37465 Pixel 6 _adb-tls-pairing._tcp 192.168.1.100:39123 Pixel 6可以看到connect服务和pairing服务的端口是分开的。脚本可以解析connect服务的端口然后直接adb connect。这样做完全不需要人眼读取端口唯一的条件是手机已经处于无线调试开启状态最好已经配对过。结合mDNS做自动连接的脚本大致是这样的思路# 用mdns服务发现拿到连接端口 PORT$(adb mdns services | grep _adb-tls-connect._tcp | head -n1 | awk -F[: ] {print $3}) IP$(adb mdns services | grep _adb-tls-connect._tcp | head -n1 | awk {print $3} | cut -d: -f1) adb connect ${IP}:${PORT}要注意的是adb mdns services的输出格式在不同平台、不同adb版本下会略有差异有的版本会带制表符有的用空格。我建议在脚本里用正则提取数字端口宁可多写两行解析也别写死格式。另外如果电脑和手机不在同一个网段或者路由器开了AP隔离mDNS广播是传不过来的这种网络环境下mDNS方案不可用需要退回USB触发方案。4.3 方案三Android Studio里集成无线调试任务适合日常开发如果你主要的场景是开发调试不想来回切窗口敲命令可以在Android Studio里把无线调试做成一个External Tool或者一个Task配置。这样每次点一下菜单就能自动完成设备发现和连接。我常用的做法是配置一个Shell脚本作为External Tools入口脚本里封装前面提到的mDNS自动发现逻辑然后在Android Studio的菜单栏里直接触发。具体配置步骤不复杂打开Android Studio的Settings找到Tools - External Tools点加号。Name填WiFi ADB ConnectProgram填/bin/bash或你脚本的绝对路径Arguments填脚本路径Working directory填项目目录。保存后菜单栏Tools下就会多出一个WiFi ADB Connect入口点击后底部Run窗口直接输出连接结果。这个方案让我在实际开发里节省了大量时间尤其是手头两台测试机来回切着调试的时候点一下菜单就跟切换数据线一样方便。而且Android Studio的Run窗口会保留脚本输出连接是否成功、端口是什么一眼就能看到比在终端里翻历史记录清晰得多。如果你更习惯IDEA风格的开发工具也可以用类似方式配置原理完全一样。4.4 方案四设备端自动化用Tasker等工具实现全自动开启以上三种方案都依赖电脑端操作手机还是要先手动开一下无线调试开关。如果你连这一步都想省那就要引入设备端自动化工具了比如Tasker、MacroDroid这类能触发系统动作的App。它们可以在特定条件下自动打开无线调试设置页甚至通过模拟点击的方式把配对开关打开。这里要强调一点普通非root设备是无法直接通过系统API打开无线调试开关的因为这是受保护设置项。Tasker能做的只是把“设置-开发者选项-无线调试”这个页面调出来然后通过系统辅助功能模拟点击把开关打开。如果你需要全自动还得结合电脑端的adb自动发现形成一套“触发即连”的完整链路。实际使用中我一般把Tasker的触发条件设置成连接指定WiFi时自动打开无线调试页面。这样到了公司手机连上办公室WiFi它会自动把无线调试准备好电脑端再用脚本一键连接两边都不用管设置页面。这个方案适合那些固定工位、固定WiFi的办公环境频繁更换网络的场景不太推荐因为每个新WiFi网络安全策略不同可能存在连接限制。5. WiFi ADB实战中的踩坑与排查技巧5.1 常见连接问题速查表不管哪种方案WiFi ADB最让人头疼的都是连接不稳定、连不上、掉线这老三样。我把实战中遇到频率最高的问题整理成了表格可以直接对照排查。现象常见原因排查方向adb pair提示超时或失败配对端口写错、手机屏幕配对码已过期重新点击“使用配对码配对设备”确认端口和配对码是当前显示的值adb connect一直卡在connecting连接端口和配对端口混用确认连接用的是“IP地址和端口”里的端口不是配对端口连接成功但adb devices显示offline设备授权弹窗未确认或者USB模式异常查看手机是否弹出“允许USB调试”提示重新插拔USB后执行adb usb恢复USB模式再试无线连接频繁断开网络信号弱、手机锁屏后WiFi休眠、路由器AP隔离在开发者选项里打开“保持唤醒状态”锁屏调试时考虑关闭WiFi休眠策略脚本里adb mdns services输出为空手机无线调试未开启、不在同一网段、路由器不支持mDNS确认手机上无线调试开关是开着的电脑和手机连同一个WiFi热点多台设备时连错设备设备IP变化、端口重复每次操作都用adb -s指定具体序列号不要依赖默认设备tcpip 5555方式在Android 13上偶发端口冲突与系统无线调试开关同时开启关闭系统自带无线调试只保留tcpip方式或者反过来只用系统无线调试排查思路上建议第一个动作永远是看状态。手机端确认无线调试开关是否还开着面板上的IP和端口是否变化了电脑端执行adb devices看看当前设备列表状态。这两步能定位80%的问题。5.2 稳定性优化让无线调试在长时间任务中不掉链子WiFi ADB在Android 13上已经比早期版本稳了很多但长时间跑自动化测试时我还踩过几个坑。首先是手机锁屏问题默认情况下手机息屏一段时间后WiFi模块可能进入低功耗模式导致ADB连接直接断掉。解决方法是开发者选项里的“充电时保持唤醒状态”打开或者直接把锁屏时间调长如果是root设备还可以通过adb shell svc power stayon true设置充电不休眠。其次是网络环境的影响。办公WiFi如果开了AP隔离设备之间是无法直接互访的WiFi ADB在这种网络下基本用不了。我建议搭建无线调试环境时首选手机开热点让电脑连热点或者用一台单独的随身路由把设备都挂在同一个AP下这样网络层的问题最少。还有一个容易忽略的点电脑端的防火墙。Windows自带的防火墙有时会把adb的连接端口拦截掉尤其是第一次运行时弹窗询问是否允许adb通过防火墙如果你手快点掉“取消”后面所有无线连接都会失败。遇到这种问题直接去防火墙设置里手动放行adb.exe或者干脆把当前网络配置文件改成“专用网络”很多奇怪的连接失败就解决了。5.3 安全提醒无线调试虽然方便但别在公共场合裸奔无线调试本质上是开放了一个网络调试端口虽然Android 13有配对码验证但一旦配对完成后端口依然暴露在局域网里。如果公司或公共场所的WiFi不可信或者说你和别人共享同一个WiFi对方技术够好的话存在被连接调试的风险。所以我的建议是公共网络环境下不要开无线调试不用的时候果断关掉开关或者至少在开发者选项里把“网络审计日志”打开对异常连接保持敏感。另外要提醒的是adb tcpip 5555这种传统方式的端口是固定且没有配对码机制的安全性比系统无线调试差得多。我在公司内网测试机上用过一段时间后来统一改成系统无线调试了就是为了减少暴露面。如果你只是自己家用或者纯本地调试问题不大但涉及公司设备或者公网环境至少要把端口访问和网络策略收紧。6. 从手动到自动的完整链路我目前最推荐的使用姿势综合对比下来我目前最顺手的组合是设备端开无线调试开关电脑端mDNS自动发现脚本Android Studio外部工具入口。具体分工是手机连上公司WiFi后手动打开无线调试这步暂时没法完全省除非你用Tasker自动点击电脑端运行一个一键脚本脚本先尝试adb mdns services自动发现设备拿到连接端口后直接adb connect再把脚本挂到Android Studio的External Tools里日常开发点一下菜单就能连上完全不用打开终端。这套组合的优势在于mDNS方式把最大的不确定性即动态端口解决掉了不需要每次查看手机屏幕。而USB触发脚本作为备用方案解决的是无线调试还没开启、或者mDNS被网络禁掉的情况。两条路互补基本覆盖了我在开发、测试、自动化脚本运行的所有场景。我在真实项目中已经跑了半年多每天至少重复连接手机五六次体验比之前插拔USB线舒服太多。唯一需要适应的就是偶尔网络波动导致的掉线重连一下脚本就好。如果你也在被数据线折磨强烈建议把这套流程搭起来省下来的时间用来多看两页文档都值了。最后分享一个小习惯我会在脚本里加上一个adb disconnect的收尾操作每次跑完自动化用例后主动断开无线连接避免端口一直被占用。下一次再用脚本连接速度更快也不容易出杂七杂八的网络冲突。这个细节不起眼但在长期反复连接的使用场景里真的能少踩很多坑。
