QAdb-Desktop
QADB
一款开源、跨平台、现代化的 ADB 桌面调试工具
让常用 ADB 操作变得更直观、更高效，不再反复手敲命令。
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 命令的高级用户
- 需要提升调试效率的开发团队
🧩 功能模块
| 模块 | 说明 |
|---|---|
| 首页 | 展示设备状态、快捷入口、常用操作 |
| 常用 | 常用 ADB 命令快捷执行 |
| 终端 | 内置命令行终端，可执行 adb / shell 命令 |
| 按键 | 模拟 Android 设备按键操作 |
| 应用 | 应用列表、安装、卸载、清数据、强制停止等 |
| 日志 | 查看和筛选 Logcat 日志 |
| 设置 | 配置工具行为、ADB 路径等 |
| 性能 | 规划中，用于查看 CPU、内存、网络等信息 |
| 进程 | 规划中，用于查看和管理设备进程 |
📦 下载
请前往 GitHub Releases 下载最新版本。
| 平台 | 推荐安装包 | 说明 |
|---|---|---|
| Windows | .msi |
推荐普通用户使用 |
| Windows | .exe |
免安装 / 便携版本 |
| Windows | .zip |
解压即用（便携包） |
| macOS | .dmg |
适用于 macOS 用户 |
macOS 如果提示“无法验证开发者”或“无法打开”，可以在「系统设置」→「隐私与安全性」中允许打开。
📝 更新日志
v2.0.5 - 2026-05-12
- 新增内置 ADB，默认开箱即用，减少手动安装和配置环境变量的步骤
- 重构终端页面，优化命令输入、执行和结果展示体验
- 优化命令中心布局，让常用命令入口更清晰、更易查找
⚡ 快速开始
1. 准备 ADB
QADB v2.0.5 起已内置 ADB，默认可直接使用。
如果你需要使用自己安装的 ADB，也可以在设置中配置自定义 ADB 路径。常见来源包括：
- Android Studio 用户通常已经自带 ADB
- 单独下载 Android SDK Platform Tools
如需验证自定义 ADB 环境，可以在终端中执行：
adb version
如果能看到 ADB 版本信息，说明自定义环境正常。
2. 开启设备调试
在 Android 设备上开启：
- 打开「开发者选项」
- 开启「USB 调试」
- 使用 USB 连接电脑
- 在设备上允许 USB 调试授权
然后执行：
adb devices
如果能看到设备列表，说明设备连接成功。
3. 启动 QADB
打开 QADB 后：
- 选择当前设备
- 查看设备状态
- 使用常用操作、应用管理、日志、终端等功能
🔌 网络 ADB 使用方式
如果你需要连接 Android TV、电视盒子或局域网设备，可以使用网络 ADB。
常见连接命令：
adb connect 192.168.1.100:5555
连接成功后，设备会出现在 QADB 的设备列表中。
不同设备开启网络 ADB 的方式可能不同，部分设备需要先通过 USB 或系统设置开启无线调试。
🛠️ 常见使用场景
Android 应用开发
- 快速安装 APK
- 清除应用数据
- 强制停止应用
- 查看应用日志
- 查看当前 Activity
- 截图和录屏
Android TV / 盒子调试
- 网络 ADB 连接设备
- 模拟遥控器按键
- 安装或卸载 APK
- 查看系统应用信息
- 调试系统设置或启动页面
测试人员
- 快速切换设备
- 批量执行常用命令
- 查看日志和截图
- 复现问题时快速收集信息
❓ 常见问题
1. 为什么检测不到设备？
请确认：
- 已使用内置 ADB，或自定义 ADB 路径配置正确
adb devices可以在终端正常执行（使用自定义 ADB 时）- 手机或设备已开启 USB 调试
- 设备已允许 USB 调试授权
- USB 数据线支持数据传输
- Windows 用户已安装对应设备驱动
2. 为什么提示找不到 adb？
请先在设置中确认当前 ADB 来源和路径状态。QADB 会优先使用可用的内置 ADB；如果你切换为自定义 ADB，请确认路径配置正确。
使用自定义 ADB 时，可以在终端执行：
adb version
如果提示命令不存在，需要安装 Android Platform Tools，或改回使用 QADB 内置 ADB。
3. macOS 提示无法打开怎么办？
如果 macOS 提示无法验证开发者，可以尝试：
- 打开「系统设置」
- 进入「隐私与安全性」
- 找到 QADB 的拦截提示
- 点击「仍要打开」
4. 是否内置 ADB？
QADB v2.0.5 起已内置 ADB，默认开箱即用，同时保留自定义 ADB 路径配置，方便使用系统已安装的 Platform Tools。
5. 是否支持 Linux？
当前主要支持 Windows 和 macOS。
Linux 支持可以作为后续计划。如果你有 Linux 打包或适配经验，欢迎参与贡献。
🗺️ Roadmap
- 设备管理
- 设备信息展示
- 常用 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
本项目基于开源协议发布，具体请查看 LICENSE。
⭐ Star 支持
如果 QADB 对你有帮助，欢迎点一个 Star 支持项目。
你的 Star 是项目持续更新的重要动力。
QADB：让 Android 调试更简单。
