Fernflower

Fernflower هو أول مفكك تحليلي عملي يعمل لجافا وربما لأي لغة برمجة عالية المستوى بشكل عام.

يتم نشر الإصدارات في مستودع IntelliJ Community.

يرجى إرسال تقارير الأخطاء وطلبات الميزات إلى [متتبع المشكلات] (في النظام الفرعي Java. Decompiler. Engine).

استخدام IntelliJ

يُضمَّن Fernflower في IntelliJ IDEA ويُستخدم بشكل أساسي لعرض كود جافا أثناء التصحيح أو التنقل عبر ملفات class.

استخدام سطر الأوامر

يمكن تشغيل Fernflower من سطر الأوامر في وضع مستقل باستخدام الأمر التالي:

java -jar fernflower.jar [-<option>=<value>]* [<source>]+ <destination>

* تعني صفر مرات أو أكثر

+ تعني مرة واحدة أو أكثر

<source>: ملف أو دليل يحتوي على ملفات سيتم فك ترجمتها. يتم فحص الدلائل بشكل متكرر. امتدادات الملفات المسموح بها هي class و zip و jar. المصادر المسبوقة بـ -e= تعني ملفات "مكتبة" لن يتم فك ترجمتها ولكن سيتم أخذها في الاعتبار عند تحليل العلاقات بين الفئات أو الطرق. خاصة إعادة تسمية المعرفات (انظر الخيار ren) يمكن أن تستفيد من معلومات حول الفئات الخارجية.

<destination>: الدليل الوجهة لوضع كود جافا الناتج فيه

<option>=<value>: خيار سطر أوامر مع القيمة المقابلة (انظر "خيارات سطر الأوامر" أدناه).

أمثلة

java -jar fernflower.jar -hes=0 -hdc=0 c:\Temp\binary\ -e=c:\Java\rt.jar c:\Temp\source\

java -jar fernflower.jar -dgs=1 c:\Temp\binary\library.jar c:\Temp\binary\Boot.class c:\Temp\source\

خيارات سطر الأوامر

باستثناء mpm و urc، فإن القيمة 1 تعني تفعيل الخيار، 0 - إلغاء التفعيل. القيمة الافتراضية، إن وجدت، مذكورة بين قوسين.

عادةً، سيتم تغيير الخيارات التالية من قبل المستخدم، إن وجدت: hes, hdc, dgs, mpm, ren, urc أما باقي الخيارات فيمكن تركها كما هي: فهي موجهة لمهندسي الهندسة العكسية المحترفين.

• rbr (1): إخفاء طرق الجسر
• rsy (0): إخفاء أعضاء الفئة الاصطناعية
• din (1): فك ترجمة الفئات الداخلية
• dc4 (1): طي مراجع الفئات 1.4
• das (1): فك ترجمة التأكيدات
• hes (1): إخفاء استدعاء super الفارغ
• hdc (1): إخفاء المنشئ الافتراضي الفارغ
• dgs (0): فك ترجمة التوقيعات العامة
• ner (1): افتراض أن العائد لا يرمي استثناءات
• den (1): فك ترجمة التعدادات
• rgn (1): إزالة استدعاء getClass() عندما يكون جزءًا من عبارة new مؤهلة
• lit (0): إخراج القيم الرقمية "كما هي"
• (0): ترميز الأحرف غير ASCII في السلاسل وحرفية الأحرف كـ Unicode escapes

إعادة تسمية المعرفات

بعض أدوات التعتيم تمنح الفئات وعناصر أعضائها أسماء قصيرة لا معنى لها وفوق كل شيء غامضة. إعادة ترجمة هذا الكود تؤدي إلى عدد كبير من التعارضات. لذلك، من المستحسن السماح لمفكك الترجمة بإعادة تسمية العناصر بدوره، ضمانًا لتفرد كل معرف.

الخيار ren (أي -ren=1) يفعّل وظيفة إعادة التسمية. استراتيجية إعادة التسمية الافتراضية كالتالي:

• إعادة تسمية عنصر إذا كان اسمه كلمة محجوزة أو أقصر من 3 أحرف
• تُبنى الأسماء الجديدة وفق نمط بسيط: (class|method|field)_<رقم فريد متتالي> يمكنك تجاوز هذه القواعد بتوفير تطبيقك الخاص للطرق الأربع الرئيسية التي يستدعيها المفكك أثناء إعادة التسمية. ببساطة قم بتمرير فئة تنفذ واجهة org.jetbrains.java.decompiler.main.extern.IMemberIdentifierRenamer في الخيار urc (مثلًا -urc=com.example.MyRenamer) إلى Fernflower. يجب أن تكون الفئة متاحة على classpath التطبيق.

يجب أن يكون معنى كل طريقة واضحًا من التسمية: toBeRenamed تحدد ما إذا كان العنصر سيتم إعادة تسميته، بينما الثلاث الأخرى توفر أسماء جديدة للفئات والطرق والحقول على التوالي.

التطوير

بناء سكريبت بدء تشغيل قابل للتنفيذ:

./gradlew :installDist

يتم إنشاء سكريبت بدء التشغيل في build/install/engine/bin.

المساهمة

Fernflower هو جزء من مشروع IntelliJ Community، المساهمات مرحب بها، والطريقة المفضلة لإرسال التصحيحات هي إنشاء طلب سحب في مستودع مجتمع IntelliJ. عند تقديم التصحيحات، يرجى اتباع إرشادات المساهمة.

الترخيص

Fernflower مرخص بموجب رخصة Apache الإصدار 2.0.

الإسناد

تم تطوير Fernflower في الأصل بواسطة Stiver ولكن تمت صيانته بواسطة JetBrains منذ 2014. تم دمج بعض التصحيحات من ForgeFlower في هذا المستودع. كما تم صيانة مرآة Fernflower بواسطة Andrew McRae لفترة طويلة جدًا.

التسمية

الاسم الصحيح هو Fernflower، وليس FernFlower.