Orchestra JADX, CFR, Procyon e Vineflower per decompilare file Android APK/AAB/XAPK/APKS, con estrazione di DEX nascosti, deoffuscamento, ricostruzione di APK firmati, analisi ELF e un'API REST locale.
Aquadecomp è una piattaforma di decompilazione di applicazioni Android che integra più decompilatori in una catena di fallback, massimizzando la copertura del codice decompilato, anche nelle app offuscate.
decompile esegue un unico flusso con tutte le fasi collegate:
recovery)new String(new byte[]{...}), new String(Base64.decode("..."))) senza alterare il resto del codicejavac reale, distinguendo gli errori di sintassi da quelli di risoluzione delle dipendenzesources/; i file modificati conservano una copia .bakInvece di dipendere da un unico strumento, Aquadecomp usa una catena multi-motore:
I motori di recupero ricevono l'APK convertito in JAR con dex2jar e processano solo le classi mancanti in sources/, così si migliora la copertura senza ripetere il lavoro.
Risultato: più classi recuperate rispetto a JADX da solo, con il motore principale che mantiene la qualità del resto del codice.
Aquadecomp non reimplementa i decompilatori: integra strumenti esistenti (JADX, CFR, Procyon, Vineflower, dex2jar, baksmali/smali, d8 e apksig) in un'unica catena con criteri di arresto, fallback, analisi e verifica. Il valore del progetto risiede in questa orchestrazione: recupero delle classi mancanti, analisi dei risultati, verifica della firma e ricostruzione dell'APK.
Il report indica il motore che ha generato ciascun file: confidence.classes[].decompiler memorizza l'etichetta per file e confidence.decompilerStats riassume quanti file ha prodotto ciascun motore. L'etichetta è un metadato, non entra nel calcolo del punteggio.
Il flusso principale calcola un punteggio di efficacia 0-100 con quattro dimensioni:
Il dettaglio è disponibile in aquedecomp-report.json (effectiveness) e nel report Markdown.
Il pacchetto verification calcola inoltre un punteggio per classe con livelli (Eccellente/Buono/Accettabile/Scarso/Inaffidabile), che è incluso nel report sotto confidence.
base/dex/ e, se il manifesto binario non esiste, si usa l'XML decodificato da JADXbase.apk) per ispezione, manifesto e recuperobase-master.apkI quattro formati vengono validati nella fase di normalizzazione; un file che non è uno ZIP valido, che non contiene contenuto Android o che ha un'estensione sconosciuta viene rifiutato con un messaggio chiaro e un report di errore generato comunque.
rebuild - ricompila le sorgenti decompilate e genera un APK firmato con le modifiche applicate (firma v1+v2+v3 con certificato proprio: installarlo richiede la disinstallazione dell'app precedente); rileva aquedecomp-mapping.txt per ripristinare il classpath e rinominare il dex con i nomi originali (vedi docs/REBUILD.md)--mapping - applica i mapping di ProGuard/R8 durante la decompilazione per recuperare classi e membri con i loro nomi originali (vedi docs/REBUILD.md)serve - API REST locale con JSON per decompilare, ispezionare, estrarre DEX nascosti, ricompilare, analizzare nativi e inferire nomi via HTTP (vedi docs/API.md)natives - analisi ELF reale dei .so del pacchetto (sezioni, export, import, dipendenze) con disassemblaggio Ghidra opzionale se installato (vedi docs/NATIVES.md)nombres - suggerimenti euristici di nomi per identificatori offuscati, solo report, senza modificare il codice (vedi docs/NAME_INFERENCE.md)unpack - estrae i DEX nascosti da un APK impacchettato con analisi statica (assets, libs e payload ZIP/zlib) e reimpacchetta l'APK con essi nella radice; decompile lo esegue automaticamente quando non ci sono DEX nella radiceapkid - identifica packer, protettori e compilatori con APKiD (regole YARA su ogni file dell'APK)bundle - converte un AAB in un file APKS con bundletool in modalità universalesimplify - deoffusca un APK con Simplify: esegue il dex in una macchina virtuale smali e riscrive i metodideobfuscator - deoffusca un APK con java-deobfuscator: rileva l'offuscatore (Zelix, Stringer, Allatori, DashO…), decifra le stringhe in sandbox isolata e reimpacchetta l'APK firmatomerge - unisce APK split in un APK unico con APKEditor (accetta cartella, .apks, .xapk e .apkm)I jar di bundletool, Simplify, java-deobfuscator e APKEditor vengono scaricati una
sola volta in ~/.aquadecomp con verifica SHA-256 e possono essere sostituiti con le
variabili AQUADECOMP_BUNDLETOOL, AQUADECOMP_SIMPLIFY,
AQUADECOMP_DEOBFUSCATOR e AQUADECOMP_APKEDITOR; APKiD si individua nel PATH
o si indica con AQUADECOMP_APKID. Dettagli in docs/USAGE.md.