JADX, CFR, Procyon 및 Vineflower를 오케스트레이션하여 Android APK/AAB/XAPK/APKS 파일을 디컴파일하며, 숨겨진 DEX 추출, 난독화 해제, 서명된 APK 재빌드, ELF 분석 및 로컬 REST API를 제공합니다.
Aquadecomp는 여러 디컴파일러를 폴백 체인으로 통합하여 난독화된 앱에서도 디컴파일된 코드의 커버리지를 극대화하는 Android 애플리케이션 디컴파일 플랫폼입니다.
decompile은 모든 단계가 연결된 단일 흐름을 실행합니다:
recovery 패키지)new String(new byte[]{...}), new String(Base64.decode("...")))을 읽을 수 있는 문자열로 변환합니다javac로 파일 샘플을 검증하여 구문 오류와 의존성 해석 오류를 구분합니다sources/의 모든 파일에 대해 엔진을 오케스트레이션합니다. 수정된 파일은 .bak 사본을 유지합니다단일 도구에 의존하는 대신, Aquadecomp는 다중 엔진 체인을 사용합니다:
복구 엔진은 dex2jar로 JAR로 변환된 APK를 받아 sources/에서 누락된 클래스만 처리하므로, 작업을 반복하지 않고 커버리지를 향상시킵니다.
결과: JADX 단독보다 더 많은 클래스를 복구하면서, 주 엔진이 나머지 코드의 품질을 유지합니다.
Aquadecomp는 디컴파일러를 재구현하지 않습니다: 기존 도구 (JADX, CFR, Procyon, Vineflower, dex2jar, baksmali/smali, d8, apksig)를 중단 기준, 폴백, 분석, 검증과 함께 단일 체인으로 통합합니다. 프로젝트의 가치는 이 오케스트레이션에 있습니다: 누락된 클래스 복구, 결과 분석, 서명 검증, APK 재구성.
보고서는 각 파일을 생성한 엔진을 나타냅니다: confidence.classes[].decompiler는 파일별 레이블을 저장하고 confidence.decompilerStats는 각 엔진이 생성한 파일 수를 요약합니다. 레이블은 메타데이터이며 점수 계산에는 포함되지 않습니다.
주 흐름은 4개 차원으로 0-100 효과성 점수를 계산합니다:
세부 내용은 aquedecomp-report.json(effectiveness)과 Markdown 보고서에 출력됩니다.
verification 패키지는 또한 등급(우수/양호/보통/미흡/신뢰 불가)과 함께 클래스별 점수를 계산하며, 이는 confidence 아래 보고서에 포함됩니다.
base/dex/의 DEX를 읽고, 바이너리 매니페스트가 없으면 JADX로 디코딩된 XML을 사용합니다base.apk)를 추출하여 검사, 매니페스트 및 복구에 사용합니다base-master.apk에 대해서도 동일하게 처리합니다네 가지 형식 모두 정규화 단계에서 검증됩니다. 유효한 ZIP이 아니거나, Android 콘텐츠를 포함하지 않거나, 알 수 없는 확장자를 가진 파일은 명확한 메시지와 함께 거부되며, 오류 보고서도 함께 생성됩니다.
rebuild - 디컴파일된 소스를 재컴파일하고 변경 사항이 적용된 서명된 APK를 생성합니다 (자체 인증서로 v1+v2+v3 서명: 설치하려면 기존 앱을 제거해야 함); aquedecomp-mapping.txt를 감지하여 classpath를 복원하고 dex를 원래 이름으로 변경합니다 (docs/REBUILD.md 참조)--mapping - 디컴파일 시 ProGuard/R8 매핑을 적용하여 클래스와 멤버를 원래 이름으로 복원합니다 (docs/REBUILD.md 참조)serve - 디컴파일, 검사, 숨겨진 DEX 추출, 재컴파일, 네이티브 분석 및 HTTP를 통한 이름 추론을 위한 JSON 기반 로컬 REST API (docs/API.md 참조)natives - 패키지의 .so 파일에 대한 실제 ELF 분석 (섹션, exports, imports, 종속성) 및 Ghidra가 설치된 경우 선택적 Ghidra 디스어셈블리 (docs/NATIVES.md 참조)nombres - 난독화된 식별자에 대한 휴리스틱 이름 제안, 보고서만 제공하며 코드는 수정하지 않음 (docs/NAME_INFERENCE.md 참조)unpack - 정적 분석을 통해 패키징된 APK에서 숨겨진 DEX를 추출하고 (assets, libs 및 ZIP/zlib 페이로드) 루트에 이들을 포함하여 APK를 재패키징합니다; 루트에 DEX가 없으면 decompile이 자동으로 실행합니다apkid - APKiD로 패커, 프로텍터 및 컴파일러를 식별합니다 (APK의 각 파일에 대한 YARA 규칙)bundle - bundletool을 사용하여 AAB를 유니버설 모드의 APKS 파일로 변환합니다simplify - Simplify로 APK를 디오브푸스케이션합니다: smali 가상 머신에서 dex를 실행하고 메서드를 재작성합니다deobfuscator - java-deobfuscator로 APK를 디오브푸스케이션합니다: 난독화 도구(Zelix, Stringer, Allatori, DashO…)를 탐지하고, 격리된 샌드박스에서 문자열을 복호화하고, 서명된 APK를 재패키징합니다merge - APKEditor로 분할 APK를 단일 APK로 병합합니다 (폴더, .apks, .xapk 및 .apkm 허용)bundletool, Simplify, java-deobfuscator 및 APKEditor의 jar는 SHA-256 검증과 함께
~/.aquadecomp에 한 번만 다운로드되며, AQUADECOMP_BUNDLETOOL, AQUADECOMP_SIMPLIFY,
AQUADECOMP_DEOBFUSCATOR 및 AQUADECOMP_APKEDITOR 변수로 대체할 수 있습니다; APKiD는 PATH에서
찾거나 AQUADECOMP_APKID로 지정합니다. 자세한 내용은 docs/USAGE.md를 참조하세요.
GitLab 파이프라인은 main에 푸시할 때마다 aquedecomp.jar를
체크섬 aquedecomp.jar.sha256과 함께 빌드합니다. 둘 다 마지막
성공한 파이프라인에서 다운로드됩니다:
curl -LO 'https://gitlab.com/droncito/aquadecomp/-/jobs/artifacts/main/raw/build/libs/aquedecomp.jar?job=jar'
curl -LO 'https://gitlab.com/droncito/aquadecomp/-/jobs/artifacts/main/raw/build/libs/aquedecomp.jar.sha256?job=jar'
사용하기 전에 무결성을 확인하세요:
# Linux / macOS
sha256sum -c aquedecomp.jar.sha256
# Windows (PowerShell)
certutil -hashfile aquedecomp.jar SHA256
.sha256 파일에 게시된 해시는 certutil의 결과와 일치해야 합니다. 그런 다음:
java -jar aquedecomp.jar --version
gradle jar
JAR은 build/libs/aquedecomp.jar에 생성됩니다.
래퍼도 존재합니다(Windows에서는 gradlew.bat build, Linux/macOS에서는 ./gradlew build).
gradle test
La suite (JUnit 5)는 네 가지 형식의 정규화, 손상된 입력, 세 가지 엔진을 사용한 복구 체인, 엔진별 출처, 디코딩된 매니페스트, 효과성 계산 및 보고서 작성을 다룹니다. 형식별 픽스처는 작은 APK로부터 scripts/make-fixtures.ps1을 사용하여 재생성됩니다.
java -jar build/libs/aquedecomp.jar [opciones] <APK_file> -o <output_dir>
java -jar aquedecomp.jar decompile signal.apk -o ./output
# Con opciones avanzadas
java -jar aquedecomp.jar decompile signal.apk \
-o ./output \
--threads 8 \
--no-md \
--no-json
# Solo inspeccionar el APK (sin descompilar)
java -jar aquedecomp.jar inspect signal.apk
# Descompilar aplicando un mapping de ProGuard/R8
java -jar aquedecomp.jar decompile signal.apk -o ./output --mapping mapping.txt
# Recompilar las fuentes editadas en un APK firmado
java -jar aquedecomp.jar rebuild ./output -o ./output-modificado.apk
# Analizar bibliotecas nativas (.so)
java -jar aquedecomp.jar natives signal.apk --so libsignal
# Sugerir nombres para identificadores ofuscados
java -jar aquedecomp.jar nombres ./output/sources --out ./output/nombres.json
# Extraer los DEX ocultos de un APK empaquetado (análisis estático)
java -jar aquedecomp.jar unpack signal.apk
# API REST local
java -jar aquedecomp.jar serve --port 8080
java -jar aquedecomp.jar --gui
# Equivalente (aparece en aquedecomp --help)
java -jar aquedecomp.jar gui
이 창은 CLI의 기능을 탭으로 제공합니다: 디컴파일, 분석(inspect), 재컴파일, 네이티브 라이브러리 분석, 이름 제안, 그리고 외부 도구(APKiD, bundletool, Simplify, APKEditor, unpack) 실행. 결과는 Reporte 및 Registro 탭에 표시됩니다.