Android 开发和测试过程中,ADB 几乎是绕不开的工具。
装包、卸载、清数据、强停、看日志、截图、录屏、查看设备信息、模拟按键、连接 Android TV 或电视盒子……这些操作本身不复杂,但每天反复敲命令,时间久了就会变成一种低效的重复劳动。
所以我做了一个开源桌面工具:QADB。
项目地址:
它是什么
QAdb-Desktop 是一款基于 Jetpack Compose Multiplatform 开发的跨平台 ADB 图形化工具,目前支持 Windows 和 macOS。
它的目标很简单:把高频 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,你可能需要:
- 安装新包
- 清除应用数据
- 强制停止应用
- 启动页面或查看当前 Activity
- 打开 Logcat
- 截图记录问题
- 必要时模拟返回、主页、方向键等操作
这些命令都能手敲,但没有必要每次都手敲。
QAdb-Desktop 希望把这类重复操作变成点击即可完成的工作流,减少上下文切换,让调试过程更顺手。
特别适合 Android TV / 盒子调试
除了常规手机调试,我个人也很关注 Android TV 和电视盒子的调试体验。
这类设备经常会遇到几个痛点:
- 输入不方便
- 需要通过网络 ADB 连接
- 经常要模拟遥控器按键
- 需要安装、卸载、查看系统应用
- 调试系统设置或启动页时,命令比较零散
QAdb-Desktop 支持网络 ADB 设备识别,也提供了常用 KeyEvent 操作,对于 TV / 盒子调试会更直观。
下载和使用
目前最新 Release 是 v2.0.1,可以在 GitHub Releases 下载:
提供的安装包包括:
- 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。
项目地址:
也欢迎参与:
- 反馈 Bug
- 补充常用 ADB 命令
- 优化 UI / 交互体验
- 完善 Windows / macOS 兼容性
- 补充教程和文档
- 参与 Linux 打包适配
QAdb-Desktop:让 Android 调试更简单。