Desktop debugging toolkit for Android & HarmonyOS
Hadice is an open-source project from Huolala. It is a cross-platform desktop app built with Wails v3. Connect HarmonyOS Next and Android devices over USB or wireless debugging to do performance monitoring, app management, file transfer, screen mirroring & recording, network capture, AI automation, and more — all from your computer.
iOS support is being rolled out gradually — stay tuned.
- Download the DMG for your platform from GitHub Releases.
- Install the app
- Double-click the downloaded DMG
- Drag
Hadice.appinto the Applications folder
- The build is unsigned. Before the first launch, run the following in Terminal (required, otherwise macOS may say it “cannot be opened” or is “damaged”):
- Open Terminal
- Run:
sudo xattr -dr com.apple.quarantine /Applications/Hadice.app- Enter your Mac login password and press Return
- Open Hadice again
- Download the Windows x64 installer EXE or portable ZIP from GitHub Releases.
- Run the installer wizard, or extract the ZIP and open
Hadice/Hadice.exewhile keepingbinandresourcesbeside it. If SmartScreen warns about an unknown app, choose Run anyway.
-
Enable Developer Mode on your phone
• HarmonyOS: Settings → About phone → Software version — tap “Software version” 7 times, then go back to Settings → System → Developer options, and enable Developer options and USB debugging
• Android: Settings → About phone — tap “Build number” 7 times, then go back to Settings → Developer options, and enable USB debugging
-
USB connection
Connect the phone to the computer with a USB cable
-
Refresh devices
• Open the device dropdown in the top-right of the app to refresh the device list
• On the phone, allow USB debugging for this computer
• If connection fails, use Connection diagnosis
- Each menu title has a help button on the right — click it for detailed usage tips
- Each menu can be opened in a separate window for parallel use
| Dependency | Notes |
|---|---|
| Go | 1.25+ |
| Node.js | 20+ recommended (with npm) |
| Task | Build task runner |
| Wails v3 CLI | go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-beta.30 |
| Android NDK + JDK | Required to build the Android capture agent (task build / task dev). NDK 25.2.9519653 |
git clone https://github.com/HuolalaTech/hadice.git
cd hadice
# Frontend dependencies
cd frontend && npm install && cd ..
# (Optional) config: analytics / update check / docs URL, etc.
cp .env.ci.example .env.citask dev| Command | Description |
|---|---|
task build:agent |
Build Android Agent only (needs NDK + JDK; native PowerShell on Windows, no WSL) |
task build |
Build for the current platform |
task build:macos:arm64 |
macOS Apple Silicon |
task build:macos:amd64 |
macOS Intel |
task build:windows:amd64 |
Windows AMD64 |
task build:cross |
Full cross-platform build |
task package:macos:arm64 |
Package macOS ARM64 DMG |
task package:windows:amd64 |
Package the Windows AMD64 installer |
task package:cross |
Package both DMGs and the Windows installer and portable ZIP |
task gen:version |
Generate backend/version.go from build/config.yml |
task gen:cienv |
Bake .env.ci into backend/cienv_generated.go (never ship the file) |
task clean |
Clean bin/ and agent artifacts |
task clean:dist |
Clean dist/ |
Output directories: dist/macos-{arch}/ for macOS and dist/windows/ for Windows (app, resources, installer, and portable ZIP). All four release filenames include the platform, architecture, and version.
Single source of truth: build/config.yml → info.version. Builds sync it into artifact names and the runtime version.
info:
version: "2.3.0".
├── main.go # Entry; embeds frontend assets
├── backend/ # Go backend (Wails Service, hdc/adb, capture, …)
├── frontend/ # React + Vite + Tailwind
├── agent/ # Android JVMTI capture agent sources (build output not committed)
├── assets/ # Platform tool binaries (hdc, adb, scrcpy, …)
├── build/ # Wails / Task build config
├── docs/ # Technical docs and screenshots
├── .env.ci.example # Private config template (do not commit a real .env.ci)
├── AGENTS.md # Repo map for AI / contributors
├── README.md # Chinese README (default)
└── README_EN.md # This file
Issues and Pull Requests are welcome. See CONTRIBUTING.md.
For security reports, see SECURITY.md. For usage help, see SUPPORT.md.
Hadice is an open-source project from Huolala and is released under the Apache License 2.0.
Copyright © 2026 深圳依时货拉拉科技有限公司
Attribution and licenses for redistributed third-party native binaries are listed in assets/NOTICE and the root NOTICE.
- Publisher: 货拉拉 (HuolalaTech/hadice)
- Code of conduct: CODE_OF_CONDUCT.md
Made with ❤️ for Android & HarmonyOS developers













