Orchestrates JADX, CFR, Procyon and Vineflower to decompile Android APK/AAB/XAPK/APKS files, with hidden DEX extraction, deobfuscation, signed APK rebuild, ELF analysis and a local REST API.
Aquadecomp es una plataforma de descompilación de aplicaciones Android que integra múltiples descompiladores en una cadena de respaldo, maximizando la cobertura del código decompilado, incluso en apps ofuscadas.
decompile ejecuta un único flujo con todas las etapas conectadas:
recovery)new String(new byte[]{...}), new String(Base64.decode("..."))) sin alterar el resto del códigojavac real, distinguiendo errores de sintaxis de los de resolución de dependenciassources/; los archivos modificados conservan una copia .bakEn lugar de depender de una única herramienta, Aquadecomp usa una cadena multi-motor:
Los motores de rescate reciben el APK convertido a JAR con dex2jar y solo procesan las clases que faltan en sources/, así se mejora la cobertura sin repetir trabajo.
Resultado: más clases recuperadas que con JADX solo, con el motor principal manteniendo la calidad del resto del código.
Aquadecomp no reimplementa descompiladores: integra herramientas existentes (JADX, CFR, Procyon, Vineflower, dex2jar, baksmali/smali, d8 y apksig) en una única cadena con criterios de parada, respaldo, análisis y verificación. El valor del proyecto está en esa orquestación: recuperación de las clases que faltan, análisis de resultados, verificación de la firma y reconstrucción del APK.
El informe indica el motor que generó cada archivo: confidence.classes[].decompiler guarda la etiqueta por archivo y confidence.decompilerStats resume cuántos archivos produjo cada motor. La etiqueta es metadato, no entra en el cálculo del puntaje.
El flujo principal calcula un puntaje de efectividad 0-100 con cuatro dimensiones:
El detalle sale en aquedecomp-report.json (effectiveness) y en el reporte Markdown.
El paquete verification calcula además un puntaje por clase con niveles (Excelente/Bueno/Aceptable/Pobre/No confiable), que se incluye en el reporte bajo confidence.
base/dex/ y, si el manifiesto binario no existe, se usa el XML decodificado por JADXbase.apk) para inspección, manifiesto y rescatebase-master.apkLos cuatro formatos se validan en la etapa de normalización; un archivo que no es ZIP válido, que no contiene contenido Android o que tiene una extensión desconocida se rechaza con un mensaje claro y un informe de error generado igualmente.
rebuild - recompila las fuentes descompiladas y genera un APK firmado con los cambios aplicados (firma v1+v2+v3 con certificado propio: instalarlo requiere desinstalar la app previa); detecta aquedecomp-mapping.txt para restaurar el classpath y renombrar el dex a los nombres originales (ver docs/REBUILD.md)--mapping - aplica mappings de ProGuard/R8 al descompilar para recuperar clases y miembros con sus nombres originales (ver docs/REBUILD.md)serve - API REST local con JSON para descompilar, inspeccionar, extraer DEX ocultos, recompilar, analizar nativos e inferir nombres por HTTP (ver docs/API.md)natives - análisis ELF real de los .so del paquete (secciones, exports, imports, dependencias) con desensamblado Ghidra opcional si está instalado (ver docs/NATIVES.md)nombres - sugerencias heurísticas de nombres para identificadores ofuscados, solo informe, sin modificar código (ver docs/NAME_INFERENCE.md)unpack - extrae los DEX ocultos de un APK empaquetado con análisis estático (assets, libs y payloads ZIP/zlib) y reempaqueta el APK con ellos en la raíz; decompile lo ejecuta automáticamente cuando no hay DEX en la raízapkid - identifica packers, protectores y compiladores con APKiD (reglas YARA sobre cada archivo del APK)bundle - convierte un AAB en un archivo APKS con bundletool en modo universalsimplify - deobfusca un APK con Simplify: ejecuta el dex en una máquina virtual smali y reescribe los métodosdeobfuscator - deobfusca un APK con java-deobfuscator: detecta el ofuscador (Zelix, Stringer, Allatori, DashO…), descifra cadenas en sandbox aislado y reempaqueta el APK firmadomerge - une APKs split en un APK único con APKEditor (acepta carpeta, .apks, .xapk y .apkm)Los jars de bundletool, Simplify, java-deobfuscator y APKEditor se descargan una
sola vez a ~/.aquadecomp con verificación SHA-256 y se pueden sustituir con las
variables AQUADECOMP_BUNDLETOOL, AQUADECOMP_SIMPLIFY,
AQUADECOMP_DEOBFUSCATOR y AQUADECOMP_APKEDITOR; APKiD se localiza en el PATH
o se indica con AQUADECOMP_APKID. Detalles en docs/USAGE.md.
El pipeline de GitLab construye aquedecomp.jar en cada push a main, junto
con su checksum aquedecomp.jar.sha256. Ambos se descargan del último
pipeline verde: