一款基于 WPF(C#)开发的 Windows 桌面工具,封装 ADB(Android Debug Bridge)常用命令,提供图形化界面实现 Android 设备的无线连接、配对、设备管理与应用调试,无需记忆命令行。内置 adb.exe 及依赖,开箱即用。
- 无线连接:输入
IP:端口即可无线连接设备,支持省略端口(默认5555)。 - 无线配对:配对窗口内置「扫码配对 / 配对码」切换条(默认扫码)。扫码配对由工具生成二维码(协议同 Android Studio),手机端「使用二维码配对设备」扫码后自动完成配对、连接在后台静默尝试;也可切到「配对码」手动输入
IP:端口与配对码配对。配对成功后直接关闭配对窗口,无需等待连接。 - 连接管理:设备列表展示、一键刷新(
F5)、定时刷新(关闭 / 3 秒 / 5 秒 / 10 秒 / 15 秒 / 20 秒 / 30 秒 / 60 秒,设置自动保存)、断开单个 / 断开所有设备;设备名称读取完成前显示unknown,读取后自动刷新。 - 历史记录:自动保存成功连接的地址,下拉框可右键「删除记录 / 清空所有记录」。
- 应用安装:右键设备行「安装应用」选择 APK,或直接把 APK 文件拖拽到设备行安装。
- 应用控制:查看 / 启用 / 禁用应用包名(系统 / 第三方 / 全部),支持一键禁用(特殊设备)。
- 设备调试:打开 Shell 窗口、实时日志 / Debug 日志查看、恢复默认 TCP 端口 / 分辨率 / DPI。
- 操作日志:独立日志窗口记录操作过程与状态,可右键复制命令。
- 其它:窗口置顶、关于信息、项目地址(含镜像)、检查更新(Gitea 仓库镜像)。
- 开发工具:Visual Studio 2019 / 2022
- 框架:
.NET Framework 4.6 - 平台:
x64
- 需要
.NET Framework 4.6运行时; 64 位 Windows系统;- 程序已内置
adb.exe及依赖(AdbWinApi.dll、AdbWinUsbApi.dll、QRCoder.dll),无需电脑另行安装 ADB 或 VC++ 运行库,Windows 10/11 开箱即用。adb 命令会自动拉起自带服务,不依赖系统中已存在的 adb 服务(Win7/8/8.1 需系统已安装 Universal C Runtime 更新)。
设置 - 关于 - 版本号,连续点击 7 次 开启开发者模式。
设置 - 系统 - 开发者选项,找到 无线调试,连接 WiFi 后开启,进入 无线调试 查看 IP 地址和端口,使用该地址即可无线连接。
注:部分设备入口位置不同,请自行寻找。
连接 WiFi 后查看设备 局域网 IP 地址,使用该地址即可无线连接,此时无需输入端口号。
注:过低版本的设备可能无法连接。
提供自包含的单文件安装程序 AdbToolsInstaller.exe,具备以下特性:
- 单个 exe 直接安装,无需先解压;
- 在「程序和功能」中始终保持唯一条目,不同版本不会重复出现;
- 升级时自动读取上次安装位置并覆盖到原目录;
- 在桌面与开始菜单创建名为
Adb连接工具的快捷方式; - 通过安装目录下的
uninstall.exe(或「程序和功能」)即可干净卸载。
重新生成安装包:在 Visual Studio 中直接生成 AdbToolsInstaller 项目(会自动编译主程序与卸载器、打包并嵌入 payload)。
配对窗口顶部提供「扫码配对 / 配对码」切换条,默认进入扫码配对。
方式一:扫码配对(推荐,默认)
- 点击「配对 (
F8)」打开配对窗口(默认即为扫码界面); - 工具生成配对二维码(协议与 Android Studio 一致),上方高亮条提示手机操作路径;
- 手机在「无线调试 - 使用二维码配对设备」界面扫描二维码,工具自动发现设备并完成配对;配对成功后配对窗口直接关闭(不弹提示),后台自动尝试连接(最多 3 次,无需等待),是否连上以设备列表为准。
注:部分老设备 ADB Wi-Fi 版本较低(v1.0)配对能力受限,扫码失败时请改用方式二。
方式二:输入配对码
- 在配对窗口点击「配对码」切换到手动模式;
- 在设备「无线调试 - 使用配对码配对设备」中获取
IP:端口与配对码; - 输入配对地址与配对码,点击「配对 (
Enter)」或按回车完成。
- 在「IP 和端口」输入框中输入设备的
IP:端口(可省略端口,默认5555); - 点击「连接 (
Enter)」或按回车,等待连接成功。
- 连接成功的地址会保存在下拉历史中;
- 展开输入框右侧下拉,右键某条记录可进行「删除记录 / 清空所有记录」。
右键已连接设备,可进行的操作:
| 菜单 | 说明 |
|---|---|
| 安装应用 | 选择 APK 文件安装到该设备 |
| 断开设备 | 断开当前设备 |
| 查看日志 - 实时日志 / Debug 日志 | 查看设备运行日志 |
| 恢复默认 - TCP 端口 / 分辨率 / DPI | 还原设备默认设置 |
| 应用控制 - Shell 窗口 | 打开命令行 Shell |
| 应用控制 - 显示包名 | 显示系统 / 第三方 / 全部应用包名 |
| 应用控制 - 指定包名 | 启用 / 禁用指定应用 |
| 应用控制 - 一键禁用 | 批量禁用(仅特殊设备可用) |
| 断开所有设备 | 断开全部连接 |
也可将 APK 文件直接拖拽到设备行进行安装。
点击菜单「查看日志」或右键设备的日志项,弹出「操作日志」窗口,记录每次操作的结果与状态;右键日志可「复制命令」便于排查。
- 设置:
- 置顶显示:以对号表示是否开启,点击切换窗口是否始终在最前;
- 定时刷新:鼠标悬停「定时刷新」即在右侧展开间隔选项(关闭 / 3 秒 / 5 秒 / 10 秒 / 15 秒 / 20 秒 / 30 秒 / 60 秒),选择后自动保存并在下次启动沿用;定时刷新在后台静默执行,不显示加载动画。
- 关于:
- 项目地址:GitHub 主页(源码浏览);
- 项目地址(镜像):Gitea 仓库(
code.hcjike.com); - 检查更新:从 Gitea 仓库的 Releases 拉取最新版本信息与安装包,发现新版本时提示更新。
- 连接失败:确认设备与电脑在同一局域网,开发者选项与无线调试已开启,且 IP/端口正确。
- 无法识别设备:Android 11+ 需先完成配对再连接;旧版本系统可能不支持无线连接。
- 配对窗口自动关闭:配对成功时配对窗口会直接关闭且不弹提示,属正常现象;此时后台会自动尝试连接(最多 3 次)并刷新列表,能否连上以设备列表为准——若列表中未出现该设备,请稍后点击「刷新 (
F5)」或重新「连接」;如需重新配对,再次点击「配对 (F8)」即可。若窗口未关闭并给出提示,则说明配对失败,按提示检查地址、配对码或网络。 - 程序无法启动:请确认已安装
.NET Framework 4.6运行时。 - 找不到程序入口:安装完成后,可从桌面或开始菜单的
Adb连接工具快捷方式启动。
本项目为开源工具,ADB 相关能力依赖 Google 官方 adb 组件,仅供学习与交流使用。