Fernflower

Fernflowerは、Java向けの最初の実際に動作する解析型逆コンパイラであり、おそらく高水準プログラミング言語全般としても最初のものです。

リリースは、Intellij Communityリポジトリ で公開されています。

バグ報告や機能リクエストは、issue tracker（サブシステムJava. Decompiler. Engine）へお送りください。

IntelliJでの使用法

FernflowerはIntelliJ IDEAにバンドルされており、主にデバッグ中やクラスファイルを参照する際にJavaコードを表示するために使用されます。

コマンドラインでの使用法

Fernflowerは、以下のコマンドを使用してスタンドアロンモードでコマンドラインから実行できます：

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

* は0回以上の繰り返しを意味します

+ は1回以上の繰り返しを意味します

<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): 修飾付きnew文の一部である getClass() 呼び出しを削除する
• lit (0): 数値リテラルを「そのまま」出力する
• asc (0): 文字列および文字リテラル内の非ASCII文字をUnicodeエスケープとしてエンコードする

識別子のリネーム

一部の難読化ツールは、クラスとそのメンバー要素に短く意味のない、とりわけ曖昧な名前を付けます。このようなコードを再コンパイルすると、多数の競合が発生します。したがって、逆コンパイラが要素をリネームして各識別子の一意性を確保することをお勧めします。

renオプション（-ren=1）はリネーム機能を有効にします。デフォルトのリネーム戦略は次のとおりです：

• 要素の名前が予約語であるか、3文字未満の場合にリネームする
• 新しい名前は単純なパターンに従って構築されます: (class|method|field)_<連続した一意の番号>

これらのルールは、リネーム中に逆コンパイラによって呼び出される4つの主要メソッドの独自の実装を提供することで上書きできます。urcオプション（例: -urc=com.example.MyRenamer）で org.jetbrains.java.decompiler.main.extern.IMemberIdentifierRenamer を実装するクラスをFernflowerに渡すだけです。このクラスはアプリケーションのクラスパス上で利用可能でなければなりません。

各メソッドの意味は名前から明らかです: toBeRenamedは要素がリネームされるかどうかを決定し、他の3つはそれぞれクラス、メソッド、フィールドの新しい名前を提供します。

開発

実行可能な起動スクリプトをビルドする：

./gradlew :installDist

起動スクリプトは build/install/engine/bin に生成されます。

貢献

FernflowerはIntelliJ Communityプロジェクトの一部です。貢献を歓迎します。パッチの送信方法としては、IntelliJ Communityリポジトリでプルリクエストを作成することを推奨します。パッチを提出する際は、コントリビューションガイドラインに従ってください。

ライセンス

FernflowerはApache License Version 2.0の下でライセンスされています。

クレジット

Fernflowerは当初Stiverによって開発されましたが、2014年以降はJetBrainsによってメンテナンスされています。ForgeFlowerからのいくつかのパッチがこのリポジトリにマージされました。FernflowerのミラーはAndrew McRaeによって長期間メンテナンスされていました。

名称

正しい名称はFernflowerであり、FernFlowerではありません。