sky adb快速上手:5分钟连接第一台Android设备的完整教程

原创2026-10-30 20:51:531,436 阅读

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 和端口,无需重复输入。

准备工作:开启目标设备的无线调试

在目标设备(被管理的手机/平板/电视/盒子)上操作:

  1. 进入 设置 → 关于手机,连续点击「版本号」7 次,开启 开发者选项
  2. 进入 开发者选项,开启 无线调试(Android 11+)
    • 传统 WiFi ADB 设备则开启「通过无线连接」或类似开关
  3. 点击「使用配对码配对设备」,屏幕上会显示 临时 IP、端口和 6 位配对码
  4. 记下这三项信息(配对窗口约 3 分钟过期,过期后重新打开即可)

⚠️ 关键前提:sky adb 所在手机与目标设备必须连接同一个 WiFi 网络,且目标设备不能只靠蜂窝数据。

5分钟连接第一台设备:3种方式任选

打开 sky adb,首页即为「设备连接」页,三种方式按需选择:

连接方式示意

方式一:手动连接(IP + 端口,最通用)

适合传统 WiFi ADB 设备,操作最快:

  1. 首页「手动连接」卡片中,输入目标设备的 IP 地址(如 192.168.0.103)
  2. 输入 ADB 端口:传统 WiFi ADB 设备通常为 5555
  3. 点击「连接」,看到 设备连接成功 提示即完成

目标设备 IP 可在其「开发者选项 → 无线调试」或「WLAN → 当前网络详情」中查看。首页连接卡片逻辑见 HomeScreen.kt。

方式二:无线调试配对(Android 11+ 推荐)

  1. 首页点击「无线配对」进入配对页
  2. 依次填入目标设备配对窗口中的 配对 IP、配对端口、6 位配对码
  3. 点击配对,成功后点击「继续连接」,自动跳转到设备详情

配对页内置了两步引导说明,配对信息在 PairingScreen.kt 中完整实现,底层调用 Kadb Pairing 能力。

方式三:局域网自动发现(找不到 IP 时用)

  1. 首页点击「发现设备」
  2. App 会优先通过 mDNS/NSD 自动发现局域网内的 _adb._tcp 服务;若无结果,自动回退到 TCP 网段扫描
  3. 扫描到设备后点击填入 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 了解全部功能细节,或继续探索应用安装、文件传输和屏幕镜像等进阶玩法。🚀

登录后查看全文
skyadb