Hadice

项目简介

Hadice 是货拉拉（HuolalaTech）开源的一款桌面端调试工具，专为鸿蒙（HarmonyOS Next）与安卓（Android）开发者打造。它通过 USB 或无线调试连接手机，让开发者在电脑上完成性能监控、应用管理、文件互传、投屏录屏、网络抓包以及 AI 自动化等一整套调试工作。项目采用 Apache-2.0 协议开源，把过去需要在多个命令行工具之间来回切换的调试流程，收敛到一个统一的图形化工作台里，显著降低鸿蒙与安卓双端开发的操作成本。

核心功能

• 设备总览：一屏查看电池、CPU、内存、存储与系统信息，快速掌握设备健康状态。
• 性能监控：以曲线呈现 CPU、内存、网络与帧率变化，支持数据导出用于后续分析。
• 进程与应用管理：按 CPU 或内存排序进程，支持搜索、结束进程，以及启动、停止、卸载应用和清理应用数据。
• 应用安装：拖拽或选择 APK / HAP 文件即可快速安装，适配鸿蒙与安卓两种包格式。
• 投屏截屏：实时镜像设备画面，支持截图、录屏与历史记录管理。
• 文件传输：设备与电脑之间双向互传，支持批量队列。
• 日志与抓包：实时查看、过滤与保存 hilog / logcat 日志；对鸿蒙和安卓进行网络抓包，支持详情预览、Mock 与导出。
• 终端与 AI 自动化：内置 HDC / ADB Shell 与本地终端；并提供基于视觉与指令的设备自动化操作能力。

技术实现

Hadice 采用前后端分离的混合架构。后端主体使用 Go 编写，借助 Wails v3 框架把 Go 逻辑与前端打包为原生桌面应用；前端使用 TypeScript 构建界面，负责设备面板、图表与交互逻辑。在设备桥接层，项目引入了 C++ 与 Java 组件，用于与鸿蒙和安卓系统底层调试接口通信，从而兼容两套不同的调试协议。代码仓库中可见 backend、frontend、agent 等清晰分层的目录结构，并配有 Makefile 与 Taskfile 统一构建流程。整体语言构成以 TypeScript 与 Go 为主，辅以 C++、Java 等，既保证了桌面端性能，也兼顾了跨平台构建的便利性。

快速上手

1. 开启开发者模式：鸿蒙进入「设置 > 系统 > 开发者选项」启用 USB 调试；安卓进入「设置 > 开发者选项」启用 USB 调试。
2. 连接设备：用数据线连接手机，或通过无线调试配对同一局域网内的设备。
3. 刷新设备：点击界面中的「刷新」，并在手机上允许此电脑调试设备；若连接异常可运行「连接诊断」。
4. 进入工作台：设备识别成功后即可直接使用性能监控、应用管理、投屏与抓包等功能。菜单标题右侧提供帮助按钮，且每个菜单都可拆分为独立窗口并行使用。

适用人群

适合鸿蒙与安卓应用开发者、移动端测试工程师、需要频繁抓包与性能分析的客户端研发，以及希望用 AI 自动化完成重复调试操作的工程团队。

官方链接

https://huolalatech.github.io/hadice/