uni-app 连接 Android 设备 ADB 详细技术手册
一、文档概述
本文档介绍：
-
uni-app 如何通过 ADB 连接 Android 设备
-
Windows / macOS ADB 配置
-
-
无线 ADB
-
logcat 日志调试
-
自动化部署
-
工控 / 自助终端场景实践
二、ADB 基础介绍
ADB（Android Debug Bridge）即：
Android 调试桥
ADB 用于：
-
安装 APK
-
查看日志
-
Shell 调试
-
文件传输
-
真机运行
通信结构：
PC
↓
adb client
↓
adb server（5037）
↓ USB/WIFI
Android adbd
三、安装 ADB
Windows
下载 Android Platform Tools 后解压：
D:\Android\platform-tools
配置环境变量 PATH：
D:\Android\platform-tools
验证：
adb version
macOS
编辑：
~/.zshrc
添加：
export PATH=$PATH:/Users/xxx/platform-tools
执行：
source ~/.zshrc
四、开启 Android USB 调试
路径：
设置
→ 关于手机
→ 连续点击版本号 7 次
然后：
开发者选项
→ USB 调试
五、连接设备
查看设备：
adb devices
正常输出：
List of devices attached
123456 device
六、uni-app 真机调试
HBuilderX：
运行
→ 运行到手机或模拟器
CLI：
npm run dev:app-plus
安装 APK：
adb install app.apk
七、ADB 常用命令
查看设备：
adb devices
安装：
adb install app.apk
覆盖安装：
adb install -r app.apk
卸载：
adb uninstall 包名
查看日志：
adb logcat
进入 shell：
adb shell
重启：
adb reboot
八、无线 ADB
开启：
开发者选项
→ 无线调试
连接：
adb connect 192.168.1.100:5555
USB 切 WIFI：
adb tcpip 5555
adb connect 192.168.1.100:5555
九、多设备管理
查看：
adb devices
指定设备：
adb -s device1 install app.apk
十、日志调试
查看日志：
adb logcat
错误日志：
adb logcat *:E
过滤：
adb logcat | findstr uniapp
十一、ADB 常见问题
unauthorized
解决：
adb kill-server
adb start-server
重新授权。
offline
解决：
adb kill-server
adb start-server
adb not found
原因：
环境变量未配置
十二、自助终端建议
推荐：
uni-app
+ Android 工控机
+ 无线 ADB
+ 自动化脚本
自动化部署：
adb install -r app.apk
adb shell am force-stop com.demo
adb shell monkey -p com.demo 1
十三、推荐工具
| 工具 | 用途 |
|---|---|
| HBuilderX | uni-app 开发 |
| Android Studio | Android 调试 |
| Scrcpy | Android 投屏 |
| Vysor | 远程调试 |
十四、总结
uni-app + adb 支持：
-
真机运行
-
APK 安装
-
无线调试
-
自动化部署
-
工控设备调试
-
Shell 控制
适合：
-
Android 工控机
-
自助终端
-
POS 设备
-
工业平板
0 / 130