Fernflower

Fernflower est le premier décompilateur analytique réellement fonctionnel pour Java et probablement pour un langage de programmation de haut niveau en général.

Les versions sont publiées dans le dépôt de la communauté IntelliJ.

Veuillez envoyer vos rapports de bugs et demandes de fonctionnalités au suivi des problèmes (dans le sous-système Java. Decompiler. Engine).

Utilisation dans IntelliJ

Fernflower est fourni avec IntelliJ IDEA et est principalement utilisé pour afficher le code Java lors du débogage ou de la navigation dans les fichiers de classe.

Utilisation en ligne de commande

Fernflower peut être exécuté en ligne de commande en mode autonome à l'aide de la commande suivante :

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

* signifie zéro ou plusieurs fois

+ signifie une ou plusieurs fois

<source> : fichier ou répertoire contenant les fichiers à décompiler. Les répertoires sont scannés récursivement. Les extensions de fichier autorisées sont class, zip et jar. Les sources préfixées par -e= désignent des fichiers « bibliothèque » qui ne seront pas décompilés mais pris en compte lors de l'analyse des relations entre classes ou méthodes. En particulier, le renommage des identifiants (voir l'option ren) peut bénéficier des informations sur les classes externes.

<destination> : répertoire de destination pour placer le code source Java résultant

<option>=<value> : une option de ligne de commande avec la valeur correspondante (voir « Options de la ligne de commande » ci-dessous).

Exemples

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\

Options de la ligne de commande

Sauf pour mpm et urc, la valeur 1 signifie que l'option est activée, 0 - désactivée. La valeur par défaut, si elle existe, est donnée entre parenthèses.

Généralement, les options suivantes seront modifiées par l'utilisateur, le cas échéant : hes, hdc, dgs, mpm, ren, urc Les autres options peuvent être laissées telles quelles : elles sont destinées aux ingénieurs en rétro-ingénierie professionnels.

• rbr (1) : masquer les méthodes pont (bridge methods)
• rsy (0) : masquer les membres de classe synthétiques
• din (1) : décompiler les classes internes
• dc4 (1) : réduire les références de classe 1.4
• das (1) : décompiler les assertions
• hes (1) : masquer l'invocation super vide
• hdc (1) : masquer le constructeur par défaut vide
• dgs (0) : décompiler les signatures génériques
• ner (1) : supposer que le retour ne lève pas d'exceptions
• den (1) : décompiler les énumérations
• rgn (1) : supprimer l'invocation de getClass() lorsqu'elle fait partie d'une instruction new qualifiée
• lit (0) : afficher les littéraux numériques « tels quels »

Renommage des identifiants

Certains obfuscateurs donnent aux classes et à leurs éléments membres des noms courts, insignifiants et surtout ambigus. La recompilation de ce code entraîne un grand nombre de conflits. Par conséquent, il est conseillé de laisser le décompilateur renommer les éléments à son tour, assurant ainsi l'unicité de chaque identifiant.

L'option ren (c'est-à-dire -ren=1) active la fonctionnalité de renommage. La stratégie de renommage par défaut est la suivante :

• renommer un élément si son nom est un mot réservé ou a moins de 3 caractères
• les nouveaux noms sont construits selon un motif simple : (class|method|field)_<numéro unique consécutif>
  Vous pouvez remplacer ces règles en fournissant votre propre implémentation des 4 méthodes clés invoquées par le décompilateur lors du renommage. Transmettez simplement une classe qui implémente org.jetbrains.java.decompiler.main.extern.IMemberIdentifierRenamer dans l'option urc (par exemple -urc=com.example.MyRenamer) à Fernflower. La classe doit être disponible sur le classpath de l'application.

La signification de chaque méthode devrait être claire d'après son nom : toBeRenamed détermine si l'élément sera renommé, tandis que les trois autres fournissent respectivement de nouveaux noms pour les classes, les méthodes et les champs.

Développement

Construire un script de démarrage exécutable :

./gradlew :installDist

Le script de démarrage est généré dans build/install/engine/bin.

Contribution

Fernflower fait partie du projet IntelliJ Community, les contributions sont les bienvenues, la manière privilégiée d'envoyer des correctifs est de créer une pull request dans le dépôt de la communauté IntelliJ. Lors de la soumission de correctifs, veuillez suivre les directives de contribution.

Licence

Fernflower est sous licence Apache License Version 2.0.

Crédits

Fernflower a été développé à l'origine par Stiver mais est maintenu par JetBrains depuis 2014. Certains correctifs de ForgeFlower ont été fusionnés dans ce dépôt. Le miroir de Fernflower a également été maintenu par Andrew McRae pendant très longtemps.

Nom

Le nom correct est Fernflower, pas FernFlower.