
مفكك جافا، ومجمّع، ومفكك تعليمات
يوفر Krakatau مُجمِّعًا (assembler) ومُفكِّكًا (disassembler) لبايت كود Java، مما يتيح لك تحويل ملفات الفئات الثنائية (classfiles) إلى صيغة نصية قابلة للقراءة البشرية، وإجراء تعديلات عليها، ثم تحويلها مجددًا إلى ملف فئة، حتى بالنسبة للشيفرة المُشوَّشة (obfuscated). يمكنك أيضًا إنشاء ملفات الفئات الخاصة بك من الصفر عبر كتابة البايت كود يدويًا، كما يمكنك فحص ومقارنة التفاصيل منخفضة المستوى للثنائيات الخاصة بـ Java. وعلى خلاف javap، يستطيع مُفكِّك Krakatau التعامل حتى مع الشيفرة المُشوَّشة بشدة، ويمكن إعادة تجميع المخرجات المُفكَّكة إلى ملف فئة.
يوفر Krakatau أيضًا مُفكِّكًا للشيفرة (decompiler) لتحويل ثنائيات Java إلى شيفرة مصدرية قابلة للقراءة. وعلى خلاف المُفكِّكات الأخرى، صُمِّم مُفكِّك Krakatau خصيصًا للتعامل مع الشيفرة المُشوَّشة ويستطيع التعامل بسهولة مع الحيل التي تُعطِّل المُفكِّكات الأخرى. ومع ذلك، لا يدعم مُفكِّك Krakatau بعض ميزات Java 8+ مثل lambdas، لذا فهو يعمل على أفضل وجه مع الشيفرة الأقدم.
صياغة المُجمِّع في Krakatau هي في الغالب مجموعة شاملة (superset) لصياغة Jasmin مع بعض حالات عدم التوافق الطفيفة، ولكن على خلاف Jasmin، يدعم Krakatau دعمًا كاملًا لمواصفات البايت كود الخاصة بـ Java 27، بل ويدعم بعض الميزات غير الموثقة الموجودة في الإصدارات القديمة من JVM. للحصول على نظرة عامة على صياغة المُجمِّع، راجع البرنامج التعليمي أو المواصفات الكاملة.
أولًا، ستحتاج إلى تثبيت Rust وCargo. ثم استنسخ هذا المستودع (repo) ونفِّذ cargo build --release. سينتج عن ذلك ملف ثنائي في target/release/krak2، يمكنك استدعاؤه مباشرةً، أو إضافته إلى PATH، أو إنشاء رابط رمزي (symlink) له، وما إلى ذلك.
يمتلك المُفكِّك وضعين: الوضع الافتراضي ووضع الذهاب والإياب (roundtrip). الوضع الافتراضي مُحسَّن لسهولة القراءة وسهولة تعديل ملفات التجميع (assembly) الناتجة. وعند إعادة تجميع المخرجات، ستنتج ملفات فئات مكافئة في السلوك للأصل من منظور مواصفات JVM، ولكنها ليست بالضرورة متطابقة بتًا ببت (bit for bit) (على سبيل المثال، قد يُعاد ترتيب مدخلات التجمع الثابت constant pool). ينتج وضع الذهاب والإياب مخرجات ستُعاد تجميعها إلى ملفات فئات متطابقة بتًا ببت مع الأصل، لكن هذا يعني أن ملفات التجميع تحتفظ بمعلومات الترميز منخفضة المستوى التي تجعلها أصعب في القراءة، مثل الترتيب الدقيق لمدخلات التجمع الثابت. يُوصى باستخدام وضع الذهاب والإياب عند التعامل مع شيفرة تعتمد على سمات غير قياسية، مثل شيفرة CLDC أو شيفرة Scala.
مثال على الاستخدام:
krak2 dis --out temp RecordTest.class
krak2 dis --out disassembled.zip --roundtrip r0lling-challenge.jar
يمكنك إما تفكيك ملف فئة فردي أو ملف jar كامل. إذا انتهى اسم الملف المُدخل بـ .jar أو .zip، فسيُعامَل كملف jar وسيُفكَّك كل ملف .class داخل ملف jar.
يتحكم الخيار --out في موقع المخرجات. إذا كانت قيمة --out مجلدًا، فستُوضَع المخرجات في ملفات فردية تحت ذلك المجلد. وإلا، إذا انتهت قيمة --out بـ .jar أو .zip، فستُوضَع المخرجات في ملف zip واحد في ذلك الموقع. وإذا انتهت قيمة --out بـ .j، فستُكتَب المخرجات إلى ذلك الملف (لاحظ أن ملف .j واحدًا يمكن أن يحتوي على فئات متعددة - ستُفكَّك جميع الفئات وتُكتَب إلى الملف نفسه، واحدة تلو الأخرى). وإذا حُذف الخيار --out بالكامل، فستُكتَب الفئات المُفكَّكة إلى المخرجات القياسية (standard output).
للتفكيك في وضع الذهاب والإياب كما هو موضح أعلاه، مرِّر الخيار --roundtrip (أو -r اختصارًا).
يتيح لك مُجمِّع Krakatau كتابة بايت كود Java بصيغة نصية صديقة للبشر وتحويلها إلى ملفات فئات Java ثنائية.
krak2 asm --out temp Krakatau/tests/data/asm/good/strictfp.j
يمكنك إما تجميع ملف .j فردي أو ملف jar كامل. إذا انتهى اسم الملف المُدخل بـ .jar أو .zip، فسيُعامَل كأرشيف zip وسيُجمَّع كل ملف .j بداخله.
يتحكم الخيار --out في موقع الإخراج. إذا كانت قيمة --out مجلدًا، فسيتم وضع الإخراج في ملفات فردية داخل ذلك المجلد. وإلا، إذا كانت قيمة --out تنتهي بـ .jar أو .zip، فسيتم وضع الإخراج في ملف zip واحد في ذلك الموقع. إذا كانت قيمة --out تنتهي بـ .class، فسيتم كتابة ملف الفئة (classfile) الواحد الناتج إلى ذلك الملف (إذا كان الإدخال يحتوي على فئات متعددة، فسيحدث خطأ في هذه الحالة.)
لا يزال مفكك التحويل البرمجي v2 قيد التطوير. لفك التحويل البرمجي، تحتاج حاليًا إلى استخدام Krakatau v1.
النسخة الحالية من Krakatau مرخّصة وفقًا لاختيارك بين ترخيصي MIT أو Apache 2. أما Krakatau v1 وv2 حتى الالتزام baa5534ab29dbfb7b62018bed897f52073974f2f فكانت مرخّصة بدلاً من ذلك بموجب GPL3 أو أحدث.