Skip to content

Latest commit

 

History

History
295 lines (232 loc) · 9.24 KB

README_EN.md

File metadata and controls

295 lines (232 loc) · 9.24 KB

Hadice

Hadice

Desktop debugging toolkit for Android & HarmonyOS

中文 · English ·

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.


Screenshots

Device overview
Device overview
Battery, CPU, memory, storage, and system info
Performance
Performance
CPU / memory / network / FPS charts with export
Process manager
Process manager
Sort by CPU / memory, search, and kill processes
App manager
App manager
Start, stop, uninstall, and clear app data
App install
App install
Drag-and-drop or pick APK / HAP to install quickly
Screen mirror
Screen mirror
Live mirror, screenshot, record, and history
File transfer
File transfer
Bidirectional transfer with batch queue
System logs
System logs
Live hilog / logcat with filter and save
Network capture
Network capture
HarmonyOS / Android capture, detail preview, Mock, and export
System info
System info
Browse and search device system properties
Terminal
Terminal
HDC / ADB Shell and local terminal
AI automation
AI automation
Vision- and instruction-driven device automation

Download & install

macOS

  1. Download the DMG for your platform from GitHub Releases.
  2. Install the app
    • Double-click the downloaded DMG
    • Drag Hadice.app into the Applications folder
  3. 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

Windows

  1. Download the Windows x64 installer EXE or portable ZIP from GitHub Releases.
  2. Run the installer wizard, or extract the ZIP and open Hadice/Hadice.exe while keeping bin and resources beside it. If SmartScreen warns about an unknown app, choose Run anyway.

Getting started

  1. 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

  2. USB connection

    Connect the phone to the computer with a USB cable

  3. 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

Feature guide

  • Each menu title has a help button on the right — click it for detailed usage tips

Help button

  • Each menu can be opened in a separate window for parallel use

Open in window


Build from source

Requirements

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

Clone & setup

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.ci

Development

task dev

Build & package

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.

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"

Project layout (brief)

.
├── 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

Contributing

Issues and Pull Requests are welcome. See CONTRIBUTING.md.

For security reports, see SECURITY.md. For usage help, see SUPPORT.md.


License

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.

Author / Attribution


Made with ❤️ for Android & HarmonyOS developers