ddc — DEX → Java-Decompiler in Rust

English | 简体中文

ddc dekompiliert Android-DEX-Bytecode zurück in lesbares Java — in der Größenordnung realer Apps, abfragbar wie eine Datenbank und javac-verifiziert: jede der 909.689 Dateien, die es über sieben reale APKs hinweg erzeugt, parst fehlerfrei.

Highlights

• Schnell — ein 226 MB / 20-Dex-APK (weibo, 98k Klassen) wird vollständig in 5,0s dekompiliert, ein 398 MB großes Bundle (Lark) in 5,5s; pathologische Klassen laufen auf deadline-begrenzten überwachten Threads, statt den Lauf zum Hängen zu bringen.
• Kompiliert — die vollständige Ausgabe aller sieben Benchmark-APKs (reqable, Telegram, WhatsApp, weibo, weixin, qq, lark — 0,91M Dateien) besteht javac mit null Syntaxfehlern; jede Klasse eines Namenspaares mit abweichender Groß-/Kleinschreibung (X/Cua vs. X/cua) bleibt als eigene Datei erhalten, statt dass die letzte die vorherige still überschreibt.
• Progressive Dekompilierung — über 20 Query-Subcommands (Strings, Querverweise, Hierarchien, Manifest, Ressourcen, Dekompilate pro Methode) antworten in Millisekunden: zuerst Metadaten abfragen, bei Bedarf dekompilieren, den vollständigen Lauf ganz überspringen.
• DEX 035–041, vollständig — Multi-Dex-APKs, XAPK/APKS/APKM- Container, invoke-custom; Lambdas und String-Konkatenationen falten sich zurück in echtes Java ((a) -> …, Cls::name, a + b).
• Lesbare Ausgabe — lokale Namen im jadx-Stil (str, getName() → name, Kotlin-Intrinsics-Parameterstrings) statt v12; IntDef-Literale werden out of the box als ihre Konstanten dargestellt (setVisibility(8) → View.GONE; eine eingebaute android-37- Domänentabelle, --symbols überschreibt); Kotlin-Null-Check-Rauschen wird entfernt und synthetische access$NNN-Brücken werden an ihren Aufrufstellen inlined.
• Reproduzierbare Ausgabe — keine Zeitstempel; zwei Läufe diffen sauber.
• Zweisprachige CLI — Meldungen werden automatisch lokalisiert (DDC_LANG=zh|en erzwingt; englischer Fallback).
• Basiert auf jdc-core, dem maschinenneutralen Kern, der mit jcdc geteilt wird.

Installation

macOS (Homebrew):

brew install ejfkdev/tap/ddc

Windows (Scoop) — einmal den Bucket hinzufügen, dann nach Namen installieren (scoop löst eine bloße user/repo/app-Form nicht auf — Issue #3):

scoop bucket add ejfkdev https://github.com/ejfkdev/scoop-bucket
scoop install ddc

# or install straight from the manifest URL, no bucket needed:
scoop install https://raw.githubusercontent.com/ejfkdev/scoop-bucket/main/bucket/ddc.json

cargo-binstall (jede Plattform — lädt das vorgebaute Release-Binary herunter, statt zu kompilieren):

cargo binstall ddc-cli

Binaries: jedes Release liefert rohe Binaries (keine Archive) für linux-amd64, linux-arm64, windows-amd64, windows-arm64, macos-amd64 und macos-arm64 — Nicht-macOS-Builds UPX-komprimiert.

Aus dem Quellcode (Rust stable):

git clone https://github.com/ejfkdev/ddc && cd ddc
cargo build --release

Verwendung

ddc app.apk                          # full decompile → app-out/
ddc app.apk -c com.example.Foo       # one class to stdout
ddc app.apk -o - | less              # everything to stdout

ddc info app.apk                      # app context (label via arsc, package,
                                      # version, md5) + per-dex counts
ddc mainactivity app.apk             # entry point: package + launcher
ddc findrefs app.apk string token    # every const-string "token" site
ddc getmethod app.apk Foo.toString   # one method, all overloads
ddc pkg app.apk --app -o own/        # the app's own code only

Vollständige Optionen und Beispiele: ddc --help (Subcommand-Menü nach Workflow gruppiert). Die vollständige Referenz — die Semantik jeder Option, das Ausgabeformat und Verhalten jedes Subcommands — findet sich in docs/cli.md (中文).

Performance

Sieben reale APKs, Release-Build, Mittelwerte aus 3 Läufen (Apple Silicon, 6P+12E). Das 39-APK-Validierungskorpus (4,08M dekompilierte Dateien, Wandzeit / Peak-RSS / javac-Parse-Gate pro APK) findet sich in docs/validation.md (中文).

Vollständige Dekompilierung — 7 reale APKs

APK	Größe	Vollständige Dekompilierung	Peak-RSS
reqable	34 MB	0,25s	139 MB
Telegram	62 MB	5,64s	1479 MB
WhatsApp	139 MB	5,87s (99.277 Dateien — alle Klassennamenpaare mit abweichender Groß-/Kleinschreibung erhalten)	1116 MB
weibo	226 MB	5,03s	1172 MB
weixin	268 MB	11,61s	1339 MB
lark	398 MB	5,52s	1831 MB
qq	374 MB	15,92s	2459 MB

Query-Subcommands auf denselben APKs (Zellen: Zeit / Peak-RSS; strings -f <package> --with-locations, findrefs auf den Package-String und die Methode onCreate, hierarchy/disasm/ getclass auf die Launcher-Klasse jeder App):

Query-Subcommands — 13 Befehle × 7 APKs

Befehl	reqable	Telegram	WhatsApp	weibo	weixin	lark	qq
info	0.12s / 40MB	0.21s / 88MB	0.42s / 305MB	0.65s / 610MB	0.79s / 550MB	1.10s / 907MB	1.08s / 1240MB
listclasses	0.04s / 21MB	0.06s / 84MB	0.08s / 93MB	0.13s / 396MB	0.21s / 417MB	0.20s / 299MB	0.27s / 391MB
manifest	0.03s / 7MB	0.03s / 14MB	0.02s / 20MB	0.03s / 43MB	0.04s / 31MB	0.03s / 28MB	0.03s / 47MB
mainactivity	0.04s / 24MB	0.06s / 86MB	0.08s / 224MB	0.10s / 358MB	0.13s / 371MB	0.14s / 421MB	0.21s / 554MB
res	0.02s / 7MB	0.03s / 15MB	0.03s / 22MB	0.05s / 60MB	0.04s / 32MB	0.04s / 31MB	0.05s / 53MB
largest	0.05s / 29MB	0.08s / 78MB	0.15s / 236MB	0.31s / 500MB	0.32s / 500MB	0.46s / 676MB	0.66s / 810MB
strings	0.05s / 24MB	0.10s / 85MB	0.21s / 222MB	0.39s / 354MB	0.45s / 395MB	0.52s / 431MB	0.81s / 551MB
findrefs-string	0.04s / 26MB	0.05s / 70MB	0.06s / 214MB	0.10s / 403MB	0.12s / 446MB	0.07s / 335MB	0.14s / 871MB
findrefs-method	0.05s / 26MB	0.07s / 70MB	0.07s / 219MB	0.09s / 410MB	0.10s / 458MB	0.10s / 620MB	0.15s / 896MB
members	0.07s / 23MB	0.21s / 86MB	0.62s / 222MB	1.32s / 366MB	1.17s / 381MB	1.64s / 443MB	2.66s / 572MB
hierarchy	0.04s / 24MB	0.05s / 86MB	0.09s / 212MB	0.12s / 396MB	0.14s / 386MB	0.17s / 429MB	0.22s / 548MB
disasm	0.04s / 23MB	0.07s / 88MB	0.09s / 214MB	0.12s / 371MB	0.13s / 392MB	0.16s / 422MB	0.20s / 533MB
getclass	0.05s / 34MB	0.28s / 182MB	0.14s / 357MB	0.33s / 740MB	0.37s / 942MB	0.50s / 1235MB	0.76s / 1651MB

Dokumentation