QADB:把常用 ADB 命令做成桌面工具,让 Android 调试少敲一点命令

6 阅读3分钟

Android 开发和测试过程中,ADB 几乎是绕不开的工具。

装包、卸载、清数据、强停、看日志、截图、录屏、查看设备信息、模拟按键、连接 Android TV 或电视盒子……这些操作本身不复杂,但每天反复敲命令,时间久了就会变成一种低效的重复劳动。

所以我做了一个开源桌面工具:QADB

项目地址:

github.com/ludoven/QAD…

它是什么

QAdb-Desktop 是一款基于 Jetpack Compose Multiplatform 开发的跨平台 ADB 图形化工具,目前支持 WindowsmacOS

它的目标很简单:把高频 ADB 操作整理成更直观的桌面界面,让开发者、测试人员、Android TV / 电视盒子调试人员,不用在终端里反复输入命令。

如果你经常敲这些命令:

adb devices
adb install app.apk
adb shell pm clear package.name
adb shell am force-stop package.name
adb logcat
adb shell screencap
adb shell input keyevent 3

那么 QAdb-Desktop 应该会适合你。

主要功能

目前 QAdb-Desktop 已经覆盖了一批常用调试场景:

  • 设备管理:检测 USB / 网络 ADB 设备,快速切换当前设备
  • 设备信息:查看设备型号、Android 版本、屏幕信息、连接状态等
  • 应用管理:安装 APK、卸载应用、清除数据、强制停止、导出 APK
  • 常用操作:重启、关机、截图、录屏、打开设置、查看 Activity 等
  • 按键模拟:支持返回、主页、菜单、音量、方向键等常用 KeyEvent
  • 内置终端:不切换系统终端,也能直接执行 adb / shell 命令
  • 日志查看:查看 Logcat 日志,辅助定位应用运行问题
  • 命令中心:把高频 ADB 命令整理成可视化按钮
  • TV / 盒子调试:适合 Android TV、机顶盒、系统应用调试等场景

为什么做它

ADB 很强,但它默认是命令行工具。

对开发者来说,命令行不是问题;真正的问题是很多操作太高频、太重复。

比如测试一个 APK,你可能需要:

  1. 安装新包
  2. 清除应用数据
  3. 强制停止应用
  4. 启动页面或查看当前 Activity
  5. 打开 Logcat
  6. 截图记录问题
  7. 必要时模拟返回、主页、方向键等操作

这些命令都能手敲,但没有必要每次都手敲。

QAdb-Desktop 希望把这类重复操作变成点击即可完成的工作流,减少上下文切换,让调试过程更顺手。

特别适合 Android TV / 盒子调试

除了常规手机调试,我个人也很关注 Android TV 和电视盒子的调试体验。

这类设备经常会遇到几个痛点:

  • 输入不方便
  • 需要通过网络 ADB 连接
  • 经常要模拟遥控器按键
  • 需要安装、卸载、查看系统应用
  • 调试系统设置或启动页时,命令比较零散

QAdb-Desktop 支持网络 ADB 设备识别,也提供了常用 KeyEvent 操作,对于 TV / 盒子调试会更直观。

下载和使用

目前最新 Release 是 v2.0.1,可以在 GitHub Releases 下载:

github.com/ludoven/QAd…

提供的安装包包括:

  • Windows:.msi
  • Windows:.exe
  • macOS:.dmg

使用前需要确保本机已经安装 Android Platform Tools,并且终端可以正常执行:

adb version

设备连接正常后,可以通过:

adb devices

确认设备是否已被识别。

后续计划

QAdb-Desktop 还会继续补充更多能力,例如:

  • 性能监控
  • 进程管理
  • 文件管理
  • 命令收藏
  • 命令分组自定义
  • 多设备批量操作
  • ADB 路径可视化配置
  • Linux 支持
  • 插件化命令扩展

也欢迎大家提交自己常用的 ADB 命令或调试场景,让这个工具覆盖更多真实需求。

欢迎 Star 和贡献

QAdb-Desktop 是一个开源项目,如果它对你有帮助,欢迎点个 Star,也欢迎提交 Issue、功能建议或 Pull Request。

项目地址:

github.com/ludoven/QAd…

也欢迎参与:

  • 反馈 Bug
  • 补充常用 ADB 命令
  • 优化 UI / 交互体验
  • 完善 Windows / macOS 兼容性
  • 补充教程和文档
  • 参与 Linux 打包适配

QAdb-Desktop:让 Android 调试更简单。