Web ADB：在浏览器里连 Android 设备跑命令

WebADB 是什么

用过 Android 开发的同学对 ADB（Android Debug Bridge）应该不陌生。它是 Google 官方提供的调试桥，能让你从电脑端连接手机、装应用、抓日志、截屏等等。传统用法是在电脑上装 Android SDK Platform Tools，然后敲命令行。

WebADB 的想法是把这个过程搬到浏览器里完成。它基于 WebUSB 标准——这是浏览器原生支持的 USB 设备通信协议。也就是说，只要你的浏览器支持 WebUSB，就能直接和手机通过 USB 线对话，不需要装任何驱动或 SDK。

这个方案的好处很明显：

• 不用下载几个 GB 的 SDK 工具包
• 跨平台，Windows / macOS / Linux 都行，只要有 Chrome 或 Edge
• 打开网页就能用，适合临时需要跑几条 ADB 命令的场景

浏览器兼容性

不是所有浏览器都支持 WebUSB，这点得先说清楚。

所以实际使用时，桌面端的 Chrome 或 Edge 是最稳妥的选择。如果你平时用 Firefox 或 Safari，想用 WebADB 就得临时切一下浏览器了。

怎么通过浏览器连接 Android 设备

把手机和电脑连起来之前，需要在手机上做一些设置：

第一步：开启开发者选项。进入「设置」→「关于手机」，连续点击「版本号」七次，系统会提示你已经进入开发者模式。然后回到「设置」页面顶部，会出现「开发者选项」入口。

第二步：开启 USB 调试。在「开发者选项」里找到「USB 调试」，把它打开。第一次开启时会弹窗确认，点确定就行。

第三步：插上数据线。用 USB 线把手机接到电脑。手机屏幕上会弹出是否允许 USB 调试的授权对话框，勾选「一律允许使用这台计算机进行调试」（如果有的话），然后点允许。

第四步：打开网页。在 Chrome 或 Edge 里打开 WebADB 工具页，页面会请求 USB 设备访问权限，选择你的 Android 设备即可建立连接。

WebADB 常用命令有哪些

连接成功后，你可以在网页里直接输入 ADB 命令并查看结果。下面列一些日常比较常用的命令：

# 查看已连接的设备列表
adb devices

# 安装 APK 文件
adb install app.apk

# 卸载应用（保留数据）
adb uninstall -k com.example.app

# 查看设备日志（过滤关键字）
adb logcat | grep MyApp

# 截屏保存到电脑
adb exec-out screencap -p > screenshot.png

# 将文件推送到手机
adb push local_file.txt /sdcard/Download/

# 从手机拉取文件
adb pull /sdcard/Download/remote_file.txt ./

其中 adb devices 是最基础的命令，用来确认设备有没有被正确识别。如果看到一串序列号后面跟着 "device"，说明连接正常；如果是 "unauthorized"，说明还没在手机上点允许授权。

logcat 命令用来抓取 Android 系统日志，排查 App 崩溃或者调试接口问题时很常用。不过 logcat 输出量很大，一般会配合 grep 过滤关键词来缩小范围。

screencap 可以直接截取当前屏幕内容，不需要借助第三方截图工具。对于自动化测试或者远程协助的场景挺方便的。

什么时候适合用 WebADB

如果你的工作是每天大量使用 ADB 的 Android 开发者，那还是建议在本地装完整的 Platform Tools。命令行的体验更流畅，也方便写成脚本自动化。WebADB 更像是一个应急工具，解决的是"偶尔要用一下"的问题。

常见问题

设备连上了但显示 unauthorized

拔掉 USB 线重新插入，再次确认手机上的授权弹窗点了「允许」。有些手机还需要在「开发者选项」里撤销之前的 USB 调试授权再重新授权一次。

Chrome 提示找不到设备

确认用的是原装或能传数据的数据线（有些充电线只有电源线没有数据线）。另外检查手机上 USB 调试开关确实开着。

命令执行没反应

部分 ADB 命令需要 root 权限才能正常工作，比如修改系统文件或重启服务。非 root 手机上这些操作会被拒绝。