Orquestra JADX, CFR, Procyon e Vineflower para descompilar arquivos Android APK/AAB/XAPK/APKS, com extração de DEX ocultos, desofuscação, reconstrução de APK assinado, análise de ELF e uma API REST local.
Aquadecomp é uma plataforma de descompilação de aplicações Android que integra múltiplos descompiladores em uma cadeia de fallback, maximizando a cobertura do código descompilado, inclusive em apps ofuscados.
decompile executa um único fluxo com todas as etapas conectadas:
recovery)new String(new byte[]{...}), new String(Base64.decode("..."))) sem alterar o restante do códigojavac real, distinguindo erros de sintaxe dos de resolução de dependênciassources/; os arquivos modificados mantêm uma cópia .bakEm vez de depender de uma única ferramenta, Aquadecomp usa uma cadeia multi-motor:
Os motores de resgate recebem o APK convertido para JAR com dex2jar e processam apenas as classes ausentes em sources/, assim melhora-se a cobertura sem repetir trabalho.
Resultado: mais classes recuperadas do que com JADX sozinho, com o motor principal mantendo a qualidade do restante do código.
Aquadecomp não reimplementa descompiladores: integra ferramentas existentes (JADX, CFR, Procyon, Vineflower, dex2jar, baksmali/smali, d8 e apksig) em uma única cadeia com critérios de parada, fallback, análise e verificação. O valor do projeto está nessa orquestração: recuperação das classes que faltam, análise de resultados, verificação da assinatura e reconstrução do APK.
O relatório indica o motor que gerou cada arquivo: confidence.classes[].decompiler guarda a etiqueta por arquivo e confidence.decompilerStats resume quantos arquivos cada motor produziu. A etiqueta é metadado, não entra no cálculo da pontuação.
O fluxo principal calcula uma pontuação de efetividade 0-100 com quatro dimensões:
O detalhe sai em aquedecomp-report.json (effectiveness) e no relatório Markdown.
O pacote verification calcula ainda uma pontuação por classe com níveis (Excelente/Bom/Aceitável/Pobre/Não confiável), que é incluída no relatório sob confidence.
base/dex/ e, se o manifesto binário não existir, usa-se o XML decodificado pelo JADXbase.apk) é extraído para inspeção, manifesto e resgatebase-master.apkOs quatro formatos são validados na etapa de normalização; um arquivo que não é um ZIP válido, que não contém conteúdo Android ou que tem uma extensão desconhecida é rejeitado com uma mensagem clara e um relatório de erro gerado igualmente.
rebuild - recompila as fontes descompiladas e gera um APK assinado com as alterações aplicadas (assinatura v1+v2+v3 com certificado próprio: instalá-lo requer desinstalar o app anterior); detecta aquedecomp-mapping.txt para restaurar o classpath e renomear o dex para os nomes originais (ver docs/REBUILD.md)--mapping - aplica mappings de ProGuard/R8 ao descompilar para recuperar classes e membros com seus nomes originais (ver docs/REBUILD.md)serve - API REST local com JSON para descompilar, inspecionar, extrair DEX ocultos, recompilar, analisar nativos e inferir nomes via HTTP (ver docs/API.md)natives - análise ELF real dos .so do pacote (seções, exports, imports, dependências) com desmontagem Ghidra opcional se estiver instalado (ver docs/NATIVES.md)nomes - sugestões heurísticas de nomes para identificadores ofuscados, apenas relatório, sem modificar código (ver docs/NAME_INFERENCE.md)unpack - extrai os DEX ocultos de um APK empacotado com análise estática (assets, libs e payloads ZIP/zlib) e reempacota o APK com eles na raiz; decompile o executa automaticamente quando não há DEX na raizapkid - identifica packers, protetores e compiladores com APKiD (regras YARA sobre cada arquivo do APK)bundle - converte um AAB em um arquivo APKS com bundletool em modo universalsimplify - desofusca um APK com Simplify: executa o dex em uma máquina virtual smali e reescreve os métodosdeobfuscator - desofusca um APK com java-deobfuscator: detecta o ofuscador (Zelix, Stringer, Allatori, DashO…), descriptografa strings em sandbox isolado e reempacota o APK assinadomerge - une APKs split em um APK único com APKEditor (aceita pasta, .apks, .xapk e .apkm)Os jars de bundletool, Simplify, java-deobfuscator e APKEditor são baixados uma
única vez para ~/.aquadecomp com verificação SHA-256 e podem ser substituídos com as
variáveis AQUADECOMP_BUNDLETOOL, AQUADECOMP_SIMPLIFY,
AQUADECOMP_DEOBFUSCATOR e AQUADECOMP_APKEDITOR; o APKiD é localizado no PATH
ou indicado com AQUADECOMP_APKID. Detalhes em docs/USAGE.md.
O pipeline do GitLab constrói aquedecomp.jar em cada push para main, junto
com seu checksum aquedecomp.jar.sha256. Ambos são baixados do último
pipeline verde: