
Android DEX → Rust로 구현된 Java 디컴파일러 — 품질 우선: javac로 검증된 출력, 정확한 의미 보존 단순화(cure), 전체 앱을 몇 초 만에, 쿼리는 밀리초 단위로.
English | 简体中文
ddc는 Android DEX 바이트코드를 읽을 수 있는 Java로 다시 디컴파일합니다 —
실제 앱 규모에서, 데이터베이스처럼 쿼리할 수 있으며, 품질 우선:
출력은 javac의 파싱 게이트와 전체 Android 클래스패스로 검증되고,
모든 파일은 정확하고 의미를 보존하는 소스 패스로 단순화됩니다.
javac 파싱 게이트와 전체 클래스패스 배터리가
지속적으로 출력을 검증합니다; 모든 파일은 또한 cure를
거치며, 이는 동일한 게이트 결과로 출력 라인의 15%를 절감하는 정확한
단순화입니다. 39개 APK 검증 코퍼스는 현재 4,102,811 /
4,102,812 파일이 깨끗하게 파싱됩니다 (긴 리터럴 관련 주의사항 하나, 자세한 내용은
validation 참조).--fast 사용 시 ~9.7초); Telegram (62 MB)은 ~6.4초
(~3.9초). 병리적인 클래스는 실행을 멈추게 하는 대신 데드라인이 설정된
모니터링 스레드에서 실행됩니다.(a) -> …, Cls::name, a + b).v12 대신 jadx 스타일의 로컬 이름; IntDef
리터럴은 내장 android-37 테이블과 함께 상수로 렌더링됩니다
(setVisibility(8) → View.GONE); Kotlin null-check 노이즈는 제거되고
access$NNN 브리지는 인라인됩니다.ddc serve는 모든 쿼리를 REST, OpenAPI 및 스트리밍 가능한
/mcp 엔드포인트로 노출합니다; ddc mcp는 10개의 MCP 도구를 제공합니다. 출력 형식:
text, table, markdown, JSON/JSONL.DDC_LANG=zh|en, 자동 로케일 감지.jdc-core 기반으로 구축되었으며,
jcdc와 공유됩니다.macOS (Homebrew):
brew install ejfkdev/tap/ddc
Windows (Scoop) — 버킷을 한 번 추가한 다음 이름으로 설치합니다 (scoop은
user/repo/app 형식만으로는 해석하지 않습니다 — 이슈 #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
Windows (WinGet) — 패키지는 microsoft/winget-pkgs에 게시되어 있습니다:
winget install --id ejfkdev.ddc -e --source winget
모든 플랫폼 (npm) — @ejfkdev/ddc는 릴리스 바이너리를 다운로드하고
SHA-256으로 검증하는 작은 래퍼입니다(Node 18+). Linux glibc 및 완전 정적
musl 빌드가 자동으로 선택됩니다:
npm install -g @ejfkdev/ddc
설치 스크립트가 비활성화된 경우, ddc 런처가 처음 사용할 때 바이너리를 다운로드합니다. read:packages 권한이 있는 토큰을 가진 사용자를 위해 GitHub Packages도 사용할 수 있습니다:
npm config set @ejfkdev:registry https://npm.pkg.github.com/
npm config set //npm.pkg.github.com/:_authToken "$GITHUB_TOKEN"
npm install -g @ejfkdev/ddc
패키지 레지스트리 없이:
# replace with the release you want
VERSION=0.1.35
npm install -g "https://github.com/ejfkdev/ddc/releases/download/v$VERSION/ejfkdev-ddc-$VERSION.tgz"
cargo-binstall (모든 플랫폼 — 컴파일하는 대신 미리 빌드된 릴리스 바이너리를 가져옴):
cargo binstall ddc-cli
Arch Linux — 릴리스 번들을 수동으로 설치합니다(base-devel 필요). 이 번들은 ddc-bin AUR 패키지와 동일한 파일을 포함합니다:
# replace with the release you want
VERSION=0.1.35
curl -LO "https://github.com/ejfkdev/ddc/releases/download/v$VERSION/ddc-bin-$VERSION-1-aur.tar.gz"
tar xzf "ddc-bin-$VERSION-1-aur.tar.gz"
cd ddc-bin && makepkg -si
바이너리: 모든 릴리스는
linux-amd64, linux-arm64,
linux-amd64-musl, linux-arm64-musl, windows-amd64, windows-arm64,
macos-amd64, macos-arm64용 원시 바이너리(아카이브 없음)를 제공합니다 — macOS가 아닌 빌드는 UPX로 압축되어 있습니다. musl
빌드는 완전 정적 빌드이며 Alpine 및 기타 musl 배포판에서 실행됩니다.
소스에서 빌드 (Rust stable):
cargo install ddc-cli # from crates.io, compiles locally
# or build the checkout:
git clone https://github.com/ejfkdev/ddc && cd ddc
cargo build --release
패키지 매니페스트와 릴리스 번들은
packaging/에서 생성됩니다. AUR/WinGet/npm 상태와
다중 프로그램 지원은 packaging/README.md를 참조하세요.
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 listclasses app.apk # package tree with class counts
# (--full: raw names)
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 7개, 릴리스 빌드, 쿨다운 후 측정 (Apple Silicon, 6P+12E). 39개 APK 검증 코퍼스(디컴파일된 파일 4.10M개, APK별 wall time / 최대 RSS / javac 파싱 게이트)는 docs/validation.md에 있습니다 (中文).
| APK | 크기 | 전체 디컴파일 | --fast | 최대 RSS (전체) |
|---|---|---|---|---|
| reqable | 34 MB | 0.76s | 0.46s | 317 MB |
| Telegram | 62 MB | 6.43s | 3.86s | 931 MB |
| 139 MB | 23.25s | 10.34s | 1114 MB | |
| 226 MB | 19.10s | 9.73s | 1383 MB | |
| weixin | 268 MB | 33.20s | 21.94s | 1519 MB |
| lark | 398 MB | 22.29s | 12.70s | 2403 MB |
| 374 MB | 47.70s | 33.51s | 2552 MB |
v0.1.35로 2026-11-02에 기록: 셀당 3회 연속 실행(산술 평균, 최대 RSS는 실행 최댓값). 최대 RSS는 /usr/bin/time -l로 측정. WhatsApp의 전체 실행은 하나의 병리적 클래스(X.K2H)에서 데드라인 가드에 걸려 99,482개 파일을 기록한 후 종료 코드 1로 종료되며, 해당 타이밍에는 이 데드라인이 포함됩니다.
동일한 APK에 대한 쿼리 서브커맨드 (셀: 시간 / 최대 RSS;
strings -f <package> --with-locations, 패키지 문자열과 메서드 onCreate에 대한 findrefs, 각 앱의 런처 클래스에 대한 hierarchy/disasm/getclass):