ينسّق 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 سلسلة متعددة المحركات:
تتلقى محركات الإنقاذ ملف APK المحوّل إلى JAR باستخدام dex2jar وتعالج فقط الفئات المفقودة في 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/، وإذا لم يكن المانيفست الثنائي موجودًا، يُستخدم ملف XML الذي فك ترميزه JADXbase.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 محلية بصيغة JSON لفك الترجمة والفحص واستخراج ملفات DEX المخفية وإعادة التجميع وتحليل الملفات الأصلية واستنتاج الأسماء عبر HTTP (انظر docs/API.md)natives - تحليل ELF حقيقي لملفات .so في الحزمة (الأقسام، الصادرات، الواردات، التبعيات) مع تفكيك Ghidra اختياري إذا كان مثبّتًا (انظر docs/NATIVES.md)nombres - اقتراحات استكشافية لأسماء المعرّفات المشوّشة، تقرير فقط، دون تعديل الشيفرة (انظر docs/NAME_INFERENCE.md)unpack - يستخرج ملفات DEX المخفية من APK محزوم بتحليل ساكن (assets وlibs وحمولات ZIP/zlib) ويعيد تغليف APK بها في الجذر؛ ينفّذه decompile تلقائيًا عندما لا يوجد DEX في الجذرapkid - يحدّد الحزم الضاغطة والحمايات والمترجمات باستخدام APKiD (قواعد YARA على كل ملف في APK)bundle - يحوّل AAB إلى ملف APKS باستخدام bundletool في الوضع الشاملsimplify - يزيل التشويش من APK باستخدام Simplify: ينفّذ dex في آلة افتراضية smali ويعيد كتابة الدوالdeobfuscator - يزيل التشويش من APK باستخدام java-deobfuscator: يكتشف المشوّش (Zelix، Stringer، Allatori، DashO…) ويفك تشفير السلاسل في بيئة معزولة ويعيد تغليف APK الموقّعmerge - يدمج ملفات APK المقسّمة في APK واحد باستخدام APKEditor (يقبل مجلدًا و.apks و.xapk و.apkm)تُنزَّل ملفات jar الخاصة بـ bundletool وSimplify وjava-deobfuscator وAPKEditor مرة
واحدة إلى ~/.aquadecomp مع التحقق من SHA-256 ويمكن استبدالها عبر
المتغيرات AQUADECOMP_BUNDLETOOL وAQUADECOMP_SIMPLIFY
وAQUADECOMP_DEOBFUSCATOR وAQUADECOMP_APKEDITOR؛ يُحدَّد موقع APKiD في PATH
أو يُشار إليه عبر AQUADECOMP_APKID. التفاصيل في docs/USAGE.md.
يبني خط أنابيب GitLab ملف aquedecomp.jar عند كل دفع إلى main، مع
بصمة التحقق الخاصة به 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
يجب أن يتطابق التجزئة (hash) المنشورة في ملف .sha256 مع ناتج
certutil. بعد ذلك:
java -jar aquedecomp.jar --version
gradle jar
يتم إنشاء ملف JAR في build/libs/aquedecomp.jar
يوجد أيضًا الغلاف (gradlew.bat build على Windows، و./gradlew build على Linux/macOS).
gradle test
تغطي الحزمة (JUnit 5) تطبيع الصيغ الأربع، والمدخلات التالفة، وسلسلة الإنقاذ بالمحركات الثلاثة، ومصدر البيانات لكل محرك، والبيان المفكوك، وحساب الفعالية، وكتابة التقارير. تُعاد تهيئة fixtures الصيغ باستخدام scripts/make-fixtures.ps1 انطلاقًا من ملف APK صغير.