QADB

一款开源、跨平台、现代化的 ADB 桌面调试工具

让常用 ADB 操作变得更直观、更高效，不再反复手敲命令。

官网 | 中文 | English

QADB 是一款基于 Jetpack Compose Multiplatform 开发的跨平台 ADB 图形化工具，支持 Windows 和 macOS。

它面向 Android 开发者、测试人员、Android TV / 电视盒子调试人员以及经常使用 ADB 命令的高级用户，将常用 ADB 操作封装为直观的可视化界面，帮助你更高效地完成设备调试、应用管理、日志查看、截图录屏、终端执行、按键模拟等操作。

如果你经常需要输入类似下面的命令：

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 可以让这些操作变得更简单。

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

QADB 适合以下用户：

• Android 开发者
• Android 测试人员
• Android TV / 电视盒子调试人员
• 系统应用 / 预装应用调试人员
• 经常使用 ADB 命令的高级用户
• 需要提升调试效率的开发团队

请前往 GitHub Releases 下载最新版本。

macOS 如果提示“无法验证开发者”或“无法打开”，可以在「系统设置」→「隐私与安全性」中允许打开。

QADB 依赖系统中的 adb 命令。

你需要先安装 Android Platform Tools：

• Android Studio 用户通常已经自带 ADB
• 也可以单独下载 Android SDK Platform Tools

安装完成后，请确保在终端中可以正常执行：

adb version

如果能看到 ADB 版本信息，说明环境正常。

在 Android 设备上开启：

1. 打开「开发者选项」
2. 开启「USB 调试」
3. 使用 USB 连接电脑
4. 在设备上允许 USB 调试授权

然后执行：

adb devices

如果能看到设备列表，说明设备连接成功。

打开 QADB 后：

1. 选择当前设备
2. 查看设备状态
3. 使用常用操作、应用管理、日志、终端等功能

如果你需要连接 Android TV、电视盒子或局域网设备，可以使用网络 ADB。

常见连接命令：

adb connect 192.168.1.100:5555

连接成功后，设备会出现在 QADB 的设备列表中。

不同设备开启网络 ADB 的方式可能不同，部分设备需要先通过 USB 或系统设置开启无线调试。

• 快速安装 APK
• 清除应用数据
• 强制停止应用
• 查看应用日志
• 查看当前 Activity
• 截图和录屏

• 网络 ADB 连接设备
• 模拟遥控器按键
• 安装或卸载 APK
• 查看系统应用信息
• 调试系统设置或启动页面

• 快速切换设备
• 批量执行常用命令
• 查看日志和截图
• 复现问题时快速收集信息

请确认：

• 已安装 Android Platform Tools
• adb devices 可以在终端正常执行
• 手机或设备已开启 USB 调试
• 设备已允许 USB 调试授权
• USB 数据线支持数据传输
• Windows 用户已安装对应设备驱动

请确认 adb 已加入系统环境变量。

你可以在终端执行：

adb version

如果提示命令不存在，需要先安装 Android Platform Tools，并将其目录加入环境变量。

如果 macOS 提示无法验证开发者，可以尝试：

1. 打开「系统设置」
2. 进入「隐私与安全性」
3. 找到 QADB 的拦截提示
4. 点击「仍要打开」

目前 QADB 默认依赖系统已安装的 ADB。

后续可以考虑支持：

• 自动检测 ADB 路径
• 手动配置 ADB 路径
• 内置 Platform Tools
• 多版本 ADB 管理

当前主要支持 Windows 和 macOS。

Linux 支持可以作为后续计划。如果你有 Linux 打包或适配经验，欢迎参与贡献。

• 设备管理
• 设备信息展示
• 常用 ADB 操作
• 应用管理
• 按键模拟
• 截图 / 录屏
• 内置终端
• 日志查看
• 性能监控
• 进程管理
• 文件管理
• 命令收藏
• 命令分组自定义
• 多设备批量操作
• ADB 路径可视化配置
• Linux 支持
• 插件化命令扩展

欢迎提交 Issue、功能建议或 Pull Request。

你可以参与：

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

如果你有常用的 ADB 命令，也欢迎提交建议，让 QADB 的命令中心更加完善。

• JDK 17 或更高版本
• Android Studio / IntelliJ IDEA
• Gradle
• Android SDK Platform Tools

git clone https://github.com/ludoven/QADB.git
cd QADB

请使用 Android Studio 或 IntelliJ IDEA 打开项目，并运行对应的 Desktop 配置。

具体 Gradle task 可能会根据项目结构变化，请以项目实际配置为准。

本项目基于开源协议发布，具体请查看 LICENSE。

如果 QADB 对你有帮助，欢迎点一个 Star 支持项目。

你的 Star 是项目持续更新的重要动力。

QADB：让 Android 调试更简单。