编排 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 汇总每个引擎生成了多少文件。该标签是元数据,不参与评分计算。
主流程计算一个 0-100 的有效性评分,包含四个维度:
详细信息输出在 aquedecomp-report.json(effectiveness)和 Markdown 报告中。
verification 包还会计算每个类的评分及等级(优秀/良好/可接受/较差/不可靠),该评分包含在报告的 confidence 下。
base/dex/ 中的 DEX,如果二进制清单不存在,则使用 JADX 解码的 XMLbase.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 - 本地 REST API,提供 JSON,用于反编译、检查、提取隐藏 DEX、重新编译、分析原生库以及通过 HTTP 推断名称(参见 docs/API.md)natives - 对包中 .so 进行真实的 ELF 分析(节、导出、导入、依赖),如果已安装则可选使用 Ghidra 反汇编(参见 docs/NATIVES.md)nombres - 为混淆标识符提供启发式名称建议,仅生成报告,不修改代码(参见 docs/NAME_INFERENCE.md)unpack - 通过静态分析(assets、libs 和 ZIP/zlib 载荷)从加壳 APK 中提取隐藏 DEX,并将它们重新打包到 APK 根目录;当根目录中没有 DEX 时,decompile 会自动执行此操作apkid - 使用 APKiD(对 APK 中每个文件应用 YARA 规则)识别加壳器、保护器和编译器bundle - 使用 bundletool 以通用模式将 AAB 转换为 APKS 文件simplify - 使用 Simplify 对 APK 进行去混淆:在 smali 虚拟机中执行 dex 并重写方法deobfuscator - 使用 java-deobfuscator 对 APK 进行去混淆:检测混淆器(Zelix、Stringer、Allatori、DashO……),在隔离沙箱中解密字符串并重新打包已签名的 APKmerge - 使用 APKEditor 将拆分 APK 合并为单个 APK(接受文件夹、.apks、.xapk 和 .apkm)bundletool、Simplify、java-deobfuscator 和 APKEditor 的 jar 包仅下载一次到 ~/.aquadecomp,并进行 SHA-256 校验,可通过变量 AQUADECOMP_BUNDLETOOL、AQUADECOMP_SIMPLIFY、AQUADECOMP_DEOBFUSCATOR 和 AQUADECOMP_APKEDITOR 替换;APKiD 在 PATH 中查找,或通过 AQUADECOMP_APKID 指定。详情参见 docs/USAGE.md。
GitLab 流水线在每次推送到 main 时构建 aquadecomp.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
此外还存在 wrapper(Windows 上为 gradlew.bat build,Linux/macOS 上为 ./gradlew build)。
gradle test
该测试套件(JUnit 5)覆盖四种格式的规范化、损坏输入、包含三个引擎的救援链、按引擎的溯源、解码后的清单、有效性计算以及报告写入。各格式的测试夹具通过 scripts/make-fixtures.ps1 从一个小型 APK 重新生成。
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)。结果显示在“报告”和“日志”选项卡中。