Fernflower

Fernflower, Java और संभवतः सामान्यतः एक उच्च-स्तरीय प्रोग्रामिंग भाषा के लिए पहला वास्तविक रूप से कार्यशील विश्लेषणात्मक डीकंपाइलर है।

रिलीज़ Intellij Community repository में प्रकाशित की जाती हैं।

कृपया अपनी बग रिपोर्ट और फीचर अनुरोध issue tracker (सबसिस्टम Java. Decompiler. Engine में) पर भेजें।

IntelliJ उपयोग

Fernflower IntelliJ IDEA में बंडल किया जाता है और इसका प्राथमिक उपयोग डिबगिंग या क्लास फ़ाइलों में नेविगेट करते समय Java कोड दिखाने के लिए किया जाता है।

कमांड लाइन उपयोग

Fernflower को निम्नलिखित कमांड का उपयोग करके स्टैंड-अलोन मोड में कमांड लाइन से चलाया जा सकता है:

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

* का अर्थ है शून्य या अधिक बार

+ का अर्थ है एक या अधिक बार

<source>: डीकंपाइल की जाने वाली फ़ाइलों वाली फ़ाइल या निर्देशिका। निर्देशिकाओं को पुनरावर्ती रूप से स्कैन किया जाता है। अनुमत फ़ाइल एक्सटेंशन class, zip और jar हैं। -e= के साथ उपसर्गित स्रोतों का अर्थ "लाइब्रेरी" फ़ाइलें हैं जिन्हें डीकंपाइल नहीं किया जाएगा लेकिन कक्षाओं या विधियों के बीच संबंधों का विश्लेषण करते समय उन्हें ध्यान में रखा जाएगा। विशेष रूप से पहचानकर्ताओं का नाम बदलना (नीचे ren विकल्प देखें) बाहरी कक्षाओं की जानकारी से लाभ उठा सकता है।

<destination>: परिणामी Java स्रोत को रखने के लिए गंतव्य निर्देशिका

<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): खाली सुपर इन्वोकेशन को छुपाएं
• hdc (1): खाली डिफ़ॉल्ट कंस्ट्रक्टर को छुपाएं
• dgs (0): जेनेरिक सिग्नेचर को डीकंपाइल करें
• ner (1): मान लें कि रिटर्न अपवाद नहीं फेंकता
• den (1): एनुमरेशन को डीकंपाइल करें
• rgn (1): getClass() इन्वोकेशन को हटाएं, जब वह एक योग्य नए स्टेटमेंट का हिस्सा हो
• lit (0): संख्यात्मक लिटरल को "ज्यों का त्यों" आउटपुट करें

पहचानकर्ताओं का नाम बदलना

कुछ ऑबफस्केटर कक्षाओं और उनके सदस्य तत्वों को छोटे, अर्थहीन और सबसे बढ़कर अस्पष्ट नाम देते हैं। ऐसे कोड का पुनर्संकलन करने से बड़ी संख्या में विरोध उत्पन्न होते हैं। इसलिए, डीकंपाइलर को अपनी ओर से तत्वों का नाम बदलने देना उचित है, ताकि प्रत्येक पहचानकर्ता की विशिष्टता सुनिश्चित हो सके।

विकल्प ren (अर्थात -ren=1) नाम बदलने की कार्यक्षमता को सक्रिय करता है। डिफ़ॉल्ट नाम बदलने की रणनीति इस प्रकार है:

• किसी तत्व का नाम बदलें यदि उसका नाम आरक्षित शब्द है या 3 वर्णों से छोटा है
• नए नाम एक सरल पैटर्न के अनुसार बनाए जाते हैं: (class|method|field)_<लगातार अद्वितीय संख्या>
  आप इन नियमों को ओवरराइट कर सकते हैं, नाम बदलते समय डीकंपाइलर द्वारा आमंत्रित 4 मुख्य विधियों का अपना कार्यान्वयन प्रदान करके। बस एक क्लास पास करें जो org.jetbrains.java.decompiler.main.extern.IMemberIdentifierRenamer को लागू करता है, विकल्प urc में (उदा. -urc=com.example.MyRenamer) Fernflower को। क्लास एप्लिकेशन क्लासपाथ पर उपलब्ध होनी चाहिए।

प्रत्येक विधि का अर्थ नामकरण से स्पष्ट होना चाहिए: toBeRenamed यह निर्धारित करता है कि तत्व का नाम बदला जाएगा या नहीं, जबकि अन्य तीन क्रमशः कक्षाओं, विधियों और फ़ील्ड के लिए नए नाम प्रदान करते हैं।

विकास

एक निष्पादन योग्य स्टार्टअप स्क्रिप्ट बनाएं:

./gradlew :installDist

स्टार्टअप स्क्रिप्ट build/install/engine/bin में उत्पन्न होती है।

योगदान

Fernflower IntelliJ Community प्रोजेक्ट का हिस्सा है, योगदान का स्वागत है, पैच भेजने का पसंदीदा तरीका IntelliJ कम्युनिटी रिपॉजिटरी में पुल रिक्वेस्ट बनाना है। पैच जमा करते समय, कृपया योगदान दिशानिर्देशों का पालन करें।

लाइसेंस

Fernflower Apache License Version 2.0 के तहत लाइसेंस प्राप्त है।

श्रेय

Fernflower मूल रूप से Stiver द्वारा विकसित किया गया था, लेकिन 2014 से JetBrains द्वारा बनाए रखा गया है। ForgeFlower से कुछ पैच इस रिपॉजिटरी में विलय किए गए थे। Fernflower का मिरror भी Andrew McRae द्वारा लंबे समय तक बनाए रखा गया था।

नामकरण

सही नाम Fernflower है, न कि FernFlower।