ddc — Décompilateur DEX → Java en Rust

English | 简体中文

ddc décompile le bytecode Android DEX en Java lisible — à l'échelle d'applications réelles, interrogeable comme une base de données, et vérifié par javac : chacun des 909 689 fichiers qu'il produit sur sept APK réels se parse sans erreur.

Points forts

• Rapide — un APK de 226 Mo / 20 dex (weibo, 98k classes) se décompile entièrement en 5,0 s, un bundle de 398 Mo (Lark) en 5,5 s ; les classes pathologiques s'exécutent sur des threads surveillés à échéance bornée au lieu de bloquer l'exécution.
• Compile — la sortie complète des sept APK de référence (reqable, Telegram, WhatsApp, weibo, weixin, qq, lark — 0,91 M fichiers) passe javac avec zéro erreur de syntaxe ; chaque classe d'une paire de noms à casse variable (X/Cua vs X/cua) est préservée comme son propre fichier au lieu que la dernière écrase silencieusement.
• Décompilation progressive — plus de 20 sous-commandes de requête (strings, références croisées, hiérarchies, manifest, ressources, décompilations par méthode) répondent en millisecondes : interrogez d'abord les métadonnées, décompilez à la demande, sautez complètement l'exécution complète.
• DEX 035–041, complet — APK multi-dex, conteneurs XAPK/APKS/APKM, invoke-custom ; les lambdas et les concaténations de chaînes se replient en Java réel ((a) -> …, Cls::name, a + b).
• Sortie lisible — noms locaux de style jadx (str, getName() → name, chaînes de paramètres Kotlin Intrinsics) au lieu de v12 ; les littéraux IntDef s'affichent comme leurs constantes d'emblée (setVisibility(8) → View.GONE ; une table de domaine android-37 intégrée, --symbols pour remplacer) ; le bruit des vérifications de nullité Kotlin est élidé et les ponts synthétiques access$NNN sont inlinés à leurs sites d'appel.
• Sortie reproductible — pas d'horodatages ; deux exécutions se comparent proprement.
• CLI bilingue — les messages se localisent automatiquement (DDC_LANG=zh|en force ; repli en anglais).
• Basé sur jdc-core, le cœur neutre partagé avec jcdc.

Installation

macOS (Homebrew) :

brew install ejfkdev/tap/ddc

Windows (Scoop) — ajoutez le bucket une fois, puis installez par nom (scoop ne résout pas une forme nue user/repo/app — 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 (toute plateforme — récupère le binaire de release précompilé au lieu de compiler) :

cargo binstall ddc-cli

Binaires : chaque release fournit des binaires bruts (sans archives) pour linux-amd64, linux-arm64, windows-amd64, windows-arm64, macos-amd64 et macos-arm64 — les builds non-macOS sont compressés avec UPX.

Depuis les sources (Rust stable) :

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

Utilisation

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

Options et exemples complets : ddc --help (menu des sous-commandes groupé par flux de travail). La référence complète — la sémantique de chaque option, le format de sortie et le comportement de chaque sous-commande — se trouve dans docs/cli.md (中文).

Performances

Sept APK réels, build release, moyennes sur 3 exécutions (Apple Silicon, 6P+12E). Le corpus de validation de 39 APK (4,08 M fichiers décompilés, temps réel par APK / RSS maximal / porte de parsing javac) est dans docs/validation.md (中文).

Décompilation complète — 7 APK réels

APK	Taille	Décompilation complète	RSS maximal
reqable	34 MB	0.25s	139 MB
Telegram	62 MB	5.64s	1479 MB
WhatsApp	139 MB	5.87s (99,277 files — case-variant class pairs all preserved)	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

Sous-commandes de requête sur les mêmes APK (cellules : temps / RSS maximal ; strings -f <package> --with-locations, findrefs sur la chaîne du package et la méthode onCreate, hierarchy/disasm/getclass sur la classe de lancement de chaque app) :

Sous-commandes de requête — 13 commandes × 7 APK

Command	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

Documentation