Android adb 利用wlan局域网进行无线调试方法

本文最后更新于:2025年2月7日 晚上

1、基本原理

类似于网络热点共享文件,利用两端设备处于同一个局域网,能够实现数据共享,通过adb来建立tcp连接实现连接adb调试设备,数据通过无线局域网进行传输。使用wlan的便利在于省去了usb线的连接,没有线束的困扰,也方便部分场景下USB端口被禁用但需要进行调试的情况。

连接前准备:

1、PC与待连设备处于同一个局域网,即连接同一个wifi、AP热点、以太网。

2、PC与待连设备间可正常PING通网络。

注: 原则上第一点满足,第二点自动满足,如遇无法连接可通过第二点来检查网络环境问题。

2、启用开发者模式

后续的操作需要打开开发者模式来进行,Android设备中通用开启开发者模式的步骤:设置-关于设备-点击'版本号'7次进入开发者模式。

打开后,在设置-系统中会存在‘开发者选项’菜单,在其中操作调试配置:

image-20250206100500533

3、方法一:通过开发者设置启用无线调试

3.1 启用无线调试

在打开开发者模式后,进入到开发者选项,下拉至调试配置菜单,打开无线调试:

image-20250206100620811

注: 在启用前,需确保连接wifi网络,否则无法开启无线调试。

3.2 查询无线调试IP地址

开启后,进入到‘无线调试’页面:使用当前页面的IP和端口进行连接

image-20250206100830754

3.3 连接adb设备

使用adb指令连接无线调试设备:

1
adb connect IP:PORT

示例如下:

image-20250206101120782

连接成功后,设备会出现弹窗提示:

image-20250206101051913

之后就可通过adb devices查询到对应的设备,正常的进行调试了:

image-20250206110653612

无线adb与USB adb功能完全相同,区别在于设备IP改为了[IP:端口]的形式。

4、方法二:通过USB启用无线adb调试

首次连接,PC需使用USB连接到对应设备,USB连接的目的在于第一次连接会出现adb授权弹窗,需要提前允许,否则无线调试无法使用。确保此时开发者选项USB调试已打开:

image-20250206105821151

此方法适用于无wifi网络,通过android设备自带热点进行调试的场景。

4.1 Android设备启用热点

待连Android设备开启无线热点,之后检查对应WLAN网卡IP地址:

1
adb shell ifconfig

检查wlan2 IP地址:

image-20230411200715363

4.2 TCP端口启用

待连Android设备,开启tcp连接,放开5555端口(可自定义1023-65535都可以用)

1
2
# 以5555端口开启TCP连接
adb tcpid 5555

执行无报错即可:

image-20230804111208300

此时已经开启了无线调试,使用WLAN网络IP及端口进行连接。

4.3 连接adb设备

PC连接Android设备热点,确保PC与待连设备在同一个局域网中。PC指定5555端口(4-2节配置的端口)连接设备:

1
adb connect 192.168.46.1:5555

image-20230804111304500

出现connected表示已连接adb设备。

4.4 检查设备连接

检查设备连接:

1
adb devices -l

已连接的设备展示如下:

image-20231031002843478

后续可以正常的执行所有支持的adb指令:

image-20230804111451998

4.5 断开无线设备

通过disconnect参数:

1
2
# 断开指定的无线设备
adb disconnect 192.168.46.1:5555

单独执行adb disconnect断开所有的设备。


Android adb 利用wlan局域网进行无线调试方法
http://www.codestar.top/2023/10/31/Android/Android adb 利用wlan局域网进行无线调试方法/
作者
mini小新
发布于
2023年10月31日
更新于
2025年2月7日
许可协议