
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 についても同様です4つの形式はすべて正規化段階で検証されます。有効なZIPでないファイル、Androidコンテンツを含まないファイル、未知の拡張子を持つファイルは、明確なメッセージと同様に生成されるエラーレポートとともに拒否されます。
rebuild - 逆コンパイルされたソースを再コンパイルし、変更を適用した署名済みAPKを生成します(独自の証明書によるv1+v2+v3署名: インストールするには既存のアプリをアンインストールする必要があります)。aquedecomp-mapping.txt を検出してクラスパスを復元し、dexを元の名前にリネームします(docs/REBUILD.md を参照)--mapping - 逆コンパイル時にProGuard/R8のマッピングを適用し、クラスとメンバーを元の名前で復元します(docs/REBUILD.md を参照)serve - 逆コンパイル、検査、隠しDEXの抽出、再コンパイル、ネイティブの分析、HTTP経由での名前推論を行うためのJSON付きローカルREST API(docs/API.md を参照)natives - パッケージ内の .so の実際のELF分析(セクション、エクスポート、インポート、依存関係)。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
スイート(JUnit 5)は、4つの形式の正規化、破損した入力、3つのエンジンによるレスキュー連鎖、エンジンごとの来歴、デコードされたマニフェスト、有効性の計算、レポートの書き込みをカバーしています。形式のフィクスチャは、小さな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)の実行です。結果は「レポート」タブと「ログ」タブに表示されます。