Skip to content
hcjikePublic

About

一个PC使用的adb无线连接安卓设备的小工具

Resources

Stars

9 stars

Watchers

0 watching

Forks

Repository files navigation

releases license downloads last-commit

AdbTools

一款基于 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 次 开启开发者模式。

安卓 11 及以上

设置 - 系统 - 开发者选项,找到 无线调试,连接 WiFi 后开启,进入 无线调试 查看 IP 地址和端口,使用该地址即可无线连接。

注:部分设备入口位置不同,请自行寻找。

安卓 11 以下

连接 WiFi 后查看设备 局域网 IP 地址,使用该地址即可无线连接,此时无需输入端口号。

注:过低版本的设备可能无法连接。

安装和使用

提供自包含的单文件安装程序 AdbToolsInstaller.exe,具备以下特性:

  • 单个 exe 直接安装,无需先解压;
  • 在「程序和功能」中始终保持唯一条目,不同版本不会重复出现;
  • 升级时自动读取上次安装位置并覆盖到原目录;
  • 在桌面与开始菜单创建名为 Adb连接工具 的快捷方式;
  • 通过安装目录下的 uninstall.exe(或「程序和功能」)即可干净卸载。

重新生成安装包:在 Visual Studio 中直接生成 AdbToolsInstaller 项目(会自动编译主程序与卸载器、打包并嵌入 payload)。

使用说明

设备配对(Android 11+)

配对窗口顶部提供「扫码配对 / 配对码」切换条,默认进入扫码配对。

方式一:扫码配对(推荐,默认)

  1. 点击「配对 (F8)」打开配对窗口(默认即为扫码界面);
  2. 工具生成配对二维码(协议与 Android Studio 一致),上方高亮条提示手机操作路径;
  3. 手机在「无线调试 - 使用二维码配对设备」界面扫描二维码,工具自动发现设备并完成配对;配对成功后配对窗口直接关闭(不弹提示),后台自动尝试连接(最多 3 次,无需等待),是否连上以设备列表为准。

注:部分老设备 ADB Wi-Fi 版本较低(v1.0)配对能力受限,扫码失败时请改用方式二。

方式二:输入配对码

  1. 在配对窗口点击「配对码」切换到手动模式;
  2. 在设备「无线调试 - 使用配对码配对设备」中获取 IP:端口 与配对码;
  3. 输入配对地址与配对码,点击「配对 (Enter)」或按回车完成。

设备连接

  1. 在「IP 和端口」输入框中输入设备的 IP:端口(可省略端口,默认 5555);
  2. 点击「连接 (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 组件,仅供学习与交流使用。

About

一个PC使用的adb无线连接安卓设备的小工具

Resources

Stars

9 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages