Fernflower

Fernflower è il primo decompilatore analitico realmente funzionante per Java e probabilmente per un linguaggio di programmazione di alto livello in generale.

Le release sono pubblicate nel Intellij Community repository.

Si prega di inviare segnalazioni di bug e richieste di funzionalità al issue tracker (nel sottosistema Java. Decompiler. Engine).

Utilizzo in IntelliJ

Fernflower è integrato in IntelliJ IDEA e viene utilizzato principalmente per mostrare codice Java durante il debugging o la navigazione attraverso file class.

Utilizzo da riga di comando

Fernflower può essere eseguito da riga di comando in modalità standalone utilizzando il seguente comando:

java -jar fernflower.jar [-<opzione>=<valore>]* [<sorgente>]+ <destinazione>

* significa zero o più volte

+ significa una o più volte

<sorgente>: file o directory contenente file da decompilare. Le directory vengono scansionate ricorsivamente. Le estensioni di file consentite sono class, zip e jar. Le sorgenti con prefisso -e= indicano file "libreria" che non verranno decompilati ma presi in considerazione nell'analisi delle relazioni tra classi o metodi. In particolare la rinomina degli identificatori (vedi l'opzione ren) può beneficiare delle informazioni sulle classi esterne.

<destinazione>: directory di destinazione in cui posizionare il codice Java risultante

<opzione>=<valore>: un'opzione da riga di comando con il corrispondente valore (vedi "Opzioni da riga di comando" sotto).

Esempi

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\

Opzioni da riga di comando

Ad eccezione di mpm e urc, il valore 1 indica che l'opzione è attivata, 0 - disattivata. Il valore predefinito, se presente, è indicato tra parentesi.

Tipicamente, le seguenti opzioni verranno modificate dall'utente, se del caso: hes, hdc, dgs, mpm, ren, urc Le restanti opzioni possono essere lasciate così come sono: sono destinate a reverse engineer professionisti.

• rbr (1): nascondi metodi bridge
• rsy (0): nascondi membri di classe sintetici
• din (1): decompila classi interne
• dc4 (1): collassa riferimenti a classi 1.4
• das (1): decompila asserzioni
• hes (1): nascondi invocazione super vuota
• hdc (1): nascondi costruttore predefinito vuoto
• dgs (0): decompila firme generiche
• ner (1): assumi return che non lancia eccezioni
• den (1): decompila enumerazioni
• rgn (1): rimuovi invocazione getClass() quando fa parte di un'istruzione new qualificata
• lit (0): output di valori numerici "così come sono"

Rinomina degli identificatori

Alcuni offuscatori assegnano alle classi e ai loro membri nomi brevi, privi di significato e soprattutto ambigui. Ricompilare tale codice porta a un gran numero di conflitti. Pertanto, è consigliabile lasciare che il decompilatore rinomini gli elementi a sua volta, garantendo l'unicità di ogni identificatore.

L'opzione ren (cioè -ren=1) attiva la funzionalità di rinomina. La strategia di rinomina predefinita funziona come segue:

• rinomina un elemento se il suo nome è una parola riservata o è più corto di 3 caratteri
• i nuovi nomi vengono costruiti secondo un semplice schema: (class|method|field)_<numero univoco consecutivo> È possibile sovrascrivere queste regole fornendo la propria implementazione dei 4 metodi chiave invocati dal decompilatore durante la rinomina. Basta passare una classe che implementa org.jetbrains.java.decompiler.main.extern.IMemberIdentifierRenamer nell'opzione urc (es. -urc=com.example.MyRenamer) a Fernflower. La classe deve essere disponibile nel classpath dell'applicazione.

Il significato di ogni metodo dovrebbe essere chiaro dal nome: toBeRenamed determina se l'elemento verrà rinominato, mentre gli altri tre forniscono nuovi nomi rispettivamente per classi, metodi e campi.

Sviluppo

Crea uno script di avvio eseguibile:

./gradlew :installDist

Lo script di avvio viene generato in build/install/engine/bin.

Contributi

Fernflower fa parte del progetto IntelliJ Community, i contributi sono benvenuti, il modo preferito per inviare patch è creare una pull request nel repository IntelliJ community. Quando si inviano patch, si prega di seguire le linee guida per i contributi.

Licenza

Fernflower è concesso in licenza secondo i termini della Apache License Version 2.0.

Crediti

Fernflower è stato originariamente sviluppato da Stiver ma è stato mantenuto da JetBrains dal 2014. Alcune patch da ForgeFlower sono state unite in questo repository. Il mirror di Fernflower è stato anche mantenuto da Andrew McRae per molto tempo.

Nome

Il nome corretto è Fernflower, non FernFlower.