sky adb快速上手:5分钟连接第一台Android设备的完整教程
sky adb快速上手:5分钟连接第一台Android设备的完整教程
sky adb 是一款运行在 Android 手机上的 ADB 管理工具(adb 助手),让你不借助电脑,就能通过 WiFi ADB / 无线调试连接并管理手机、平板、电视和盒子,实现应用管理、文件传输、屏幕镜像、Shell 命令等操作。本教程带你 5 分钟连接第一台 Android 设备,全程只需两部手机。
sky adb 是什么?
sky adb 把电脑上 adb connect 的能力搬到了手机里:
- 📶 无线调试配对:输入配对 IP、临时端口和 6 位配对码,直接完成配对
- 🌐 局域网自动发现:mDNS 自动发现 + 网段扫描,快速找到目标设备
- 📱 设备管理:查看品牌、型号、Android 版本、分辨率、电池信息
- 📦 应用管理:列表浏览、搜索、启动、停止、卸载目标设备应用
- 📁 文件管理:目录浏览、上传本机文件、下载设备文件
- 📸 截图与镜像:远程截图、屏幕镜像 + 远程触控
- ⌨️ Shell 命令:执行单条命令并查看输出与退出码
- 🧯 诊断日志:自动记录连接错误和失败原因,便于排查
提示:连接成功后,设备会自动保存到「最近设备」列表,下次可一键回填 IP 和端口,无需重复输入。
准备工作:开启目标设备的无线调试
在目标设备(被管理的手机/平板/电视/盒子)上操作:
- 进入 设置 → 关于手机,连续点击「版本号」7 次,开启 开发者选项
- 进入 开发者选项,开启 无线调试(Android 11+)
- 传统 WiFi ADB 设备则开启「通过无线连接」或类似开关
- 点击「使用配对码配对设备」,屏幕上会显示 临时 IP、端口和 6 位配对码
- 记下这三项信息(配对窗口约 3 分钟过期,过期后重新打开即可)
⚠️ 关键前提:sky adb 所在手机与目标设备必须连接同一个 WiFi 网络,且目标设备不能只靠蜂窝数据。
5分钟连接第一台设备:3种方式任选
打开 sky adb,首页即为「设备连接」页,三种方式按需选择:
方式一:手动连接(IP + 端口,最通用)
适合传统 WiFi ADB 设备,操作最快:
- 首页「手动连接」卡片中,输入目标设备的 IP 地址(如
192.168.0.103) - 输入 ADB 端口:传统 WiFi ADB 设备通常为
5555 - 点击「连接」,看到 设备连接成功 提示即完成
目标设备 IP 可在其「开发者选项 → 无线调试」或「WLAN → 当前网络详情」中查看。首页连接卡片逻辑见 HomeScreen.kt。
方式二:无线调试配对(Android 11+ 推荐)
- 首页点击「无线配对」进入配对页
- 依次填入目标设备配对窗口中的 配对 IP、配对端口、6 位配对码
- 点击配对,成功后点击「继续连接」,自动跳转到设备详情
配对页内置了两步引导说明,配对信息在 PairingScreen.kt 中完整实现,底层调用 Kadb Pairing 能力。
方式三:局域网自动发现(找不到 IP 时用)
- 首页点击「发现设备」
- App 会优先通过 mDNS/NSD 自动发现局域网内的
_adb._tcp服务;若无结果,自动回退到 TCP 网段扫描 - 扫描到设备后点击填入 IP 和端口,回到首页连接
发现功能由 AdbMdnsDiscovery.kt 和 LanAdbScanner.kt 实现。若访客网络隔离了多播,可手动在设置中配置扫描网段。
连接成功后能做什么
进入「详情」页,即可看到设备型号与连接状态,以及 8 个快捷操作入口:
| 功能 | 说明 |
|---|---|
| 应用管理 | 查看/搜索/启动/停止/卸载目标设备应用 |
| 本机应用 | 导出本机用户应用并安装到目标设备 |
| 安装 APK | 选择本机 APK 安装到目标设备 |
| 在线下载 | 下载 APK 或文件后可安装/推送到设备 |
| 文件管理 | 浏览目录、上传、下载、新建文件夹、删除 |
| Shell | 执行单条 Shell 命令并查看输出 |
| 屏幕镜像 | 实时画面 + 远程触控(基于 scrcpy-server 4.0) |
| 遥控器 | 模拟返回、主页、方向键、音量等物理按键 |
所有 ADB 操作统一封装在 KadbManager.kt,失败时会自动写入诊断日志。
连接失败?4 个最常见原因
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| 连接超时 | IP 或端口填错 | 重新核对目标设备的 IP 和端口(传统 ADB 常用 5555) |
| 提示拒绝连接 | 目标设备未开启无线调试 / WiFi ADB | 重新打开开关并确认处于同一 WiFi |
| 配对失败 | 配对码过期(约 3 分钟有效) | 重新打开目标设备配对窗口,立即填写 |
| 扫描无结果 | 访客网络隔离或网段配置不对 | 在「设置 → 扫描网段」手动配置设备所在网段(如 10.78.29.0/24) |
🧯 遇到报错别慌:打开「诊断日志」页,会记录具体错误信息和失败原因,支持一键复制,便于对照排查。相关模块见 DiagnosticLogger.kt。
推荐设置:为常用设备调优
进入「设置」页,建议按需调整:
- 默认端口:默认
5555,按目标设备实际端口修改 - 连接超时 / 命令超时:网络较差时可适当调大
- 扫描网段:跨网段、手机热点、旁路由等场景手动配置
- 镜像画质:流畅 / 均衡 / 高清三档,默认均衡,高负载设备建议流畅模式
设置项持久化逻辑见 AppSettingsStore.kt。
总结
| 步骤 | 操作 | 预计耗时 |
|---|---|---|
| 1 | 目标设备开启开发者选项和无线调试 | 1 分钟 |
| 2 | 确认两部设备在同一 WiFi | 10 秒 |
| 3 | 输入 IP + 端口连接,或完成无线配对 | 1-2 分钟 |
| 4 | 进入详情页开始管理设备 | 立即 |
至此,你已用不到 5 分钟完成了 sky adb 的第一次连接。接下来可参考项目文档 docs/README.md 了解全部功能细节,或继续探索应用安装、文件传输和屏幕镜像等进阶玩法。🚀
