ddc — декомпилятор DEX → Java на Rust

English | 简体中文

ddc декомпилирует байт-код Android DEX обратно в читаемый Java — в масштабе реальных приложений, с возможностью запросов как к базе данных и с проверкой через javac: каждый из 909 689 файлов, которые он создаёт для семи реальных APK, разбирается без ошибок.

Ключевые особенности

• Быстро — APK размером 226 МБ / 20 dex (weibo, 98 тыс. классов) полностью декомпилируется за 5.0 с, бандл 398 МБ (Lark) — за 5.5 с; патологические классы выполняются в контролируемых потоках с ограничением по времени вместо зависания всего запуска.
• Компилируется — полный вывод всех семи эталонных APK (reqable, Telegram, WhatsApp, weibo, weixin, qq, lark — 0.91 млн файлов) проходит javac с нулевым числом синтаксических ошибок; каждый класс из пары имён, различающихся регистром (X/Cua против X/cua), сохраняется как отдельный файл, а не перезаписывается последним молча.
• Прогрессивная декомпиляция — более 20 подкоманд запросов (строки, перекрёстные ссылки, иерархии, манифест, ресурсы, декомпиляция отдельных методов) отвечают за миллисекунды: сначала запрашиваются метаданные, декомпиляция по требованию, полный запуск можно вообще пропустить.
• DEX 035–041, полностью — мульти-dex APK, контейнеры XAPK/APKS/APKM, invoke-custom; лямбды и конкатенация строк сворачиваются обратно в настоящую Java ((a) -> …, Cls::name, a + b).
• Читаемый вывод — локальные имена в стиле jadx (str, getName() → name, строки параметров Kotlin Intrinsics) вместо v12; литералы IntDef отображаются как их константы из коробки (setVisibility(8) → View.GONE; встроенная таблица домена android-37, переопределяется через --symbols); шум проверок на null в Kotlin удаляется, а синтетические мосты access$NNN встраиваются в местах вызова.
• Воспроизводимый вывод — без временных меток; два запуска дают чистый diff.
• Двуязычный CLI — сообщения локализуются автоматически (DDC_LANG=zh|en принудительно; откат на английский).
• Построен на jdc-core — машинно-нейтральном ядре, общем с jcdc.

Установка

macOS (Homebrew):

brew install ejfkdev/tap/ddc

Windows (Scoop) — добавьте bucket один раз, затем установите по имени (scoop не разрешает форму 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 (любая платформа — загружает готовый бинарник релиза вместо компиляции):

cargo binstall ddc-cli

Бинарники: каждый релиз поставляется с готовыми бинарниками (без архивов) для linux-amd64, linux-arm64, windows-amd64, windows-arm64, macos-amd64 и macos-arm64 — сборки не для macOS сжаты UPX.

Из исходников (Rust stable):

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

Использование

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

Полный список опций и примеры: ddc --help (меню подкоманд, сгруппированное по рабочим процессам). Полный справочник — семантика каждой опции, формат вывода и поведение каждой подкоманды — находится в docs/cli.md (中文).

Производительность

Семь реальных APK, релизная сборка, среднее по 3 запускам (Apple Silicon, 6P+12E). Корпус валидации из 39 APK (4.08 млн декомпилированных файлов, время выполнения / пиковый RSS / проверка разбора javac для каждого APK) находится в docs/validation.md (中文).

Полная декомпиляция — 7 реальных APK

APK	Размер	Полная декомпиляция	Пиковый RSS
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

Подкоманды запросов на тех же APK (ячейки: время / пиковый RSS; strings -f <package> --with-locations, findrefs по строке пакета и методу onCreate, hierarchy/disasm/getclass для класса лаунчера каждого приложения):

Подкоманды запросов — 13 команд × 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

Документация