
Android仮想マシンおよび難読化解除ツール
Simplifyは汎用的なAndroid難読化解除ツールです。Dalvikコードを仮想的に実行し、その後、各メソッドを同じ動作をしつつ人間にとって読みやすいコードに書き換えます。その最適化は汎用的であるため、入力がどの難読化ツールによって生成されたかに関係なく機能します。
ビルドには、JAVA_HOME で選択されたJDK 21と、大文字と小文字を区別するファイルシステムが必要です。Androidフレームワークのサブモジュールを含めてクローンし、その後スタンドアロンjarをビルドします:
git clone --recursive https://github.com/CalebFenton/simplify.git
cd simplify
./gradlew :simplify:fatJar
既存のクローンでは、git submodule update --init --recursive でサブモジュールを取得します。
含まれている難読化されたサンプルアプリを簡略化します:
java -jar simplify/build/libs/simplify.jar -it "org/cf/obfuscated" -et "MainActivity" simplify/obfuscated-app.apk
実行は1分未満で完了し、最適化されたメソッド、失敗したメソッド、スキップされたメソッドのサマリーで終了し、
カレントディレクトリにobfuscated-app_simple.apkを書き出します。-oで別のパスを指定できます。すべてのオプションについては
java -jar simplify/build/libs/simplify.jar --helpを実行してください。
このプロジェクトには4つのGradleモジュールがあります。smalivmはDalvikメソッド用のサンドボックス化された仮想マシンです。これは
すべてのパス上で取りうるすべてのレジスタ値とクラス値の実行グラフを返します。一部の入力が
不明な場合でも同様です。不明な値に対する分岐は両方のアームをたどります。simplifyはそれらのグラフを読み取り、定数
伝播、デッドコード除去、unreflection、ピープホール最適化を適用し、メソッドが
変化しなくなるか--max-passesに達するまでこれを繰り返します。クラスやメソッドの名前は変更しません。demoappはsmalivmを組み込む方法を示し、sdbgは
同じ実行エンジン用の対話型デバッガです。
最適化は、メソッドの解析が完了した場合にのみ実行されます。解析が制限に達したメソッドは
スキップされたものとして報告され、変更されません。例外、同期、volatileアクセス、および他のコードから見えるオブジェクトへの書き込みは観測可能であるため、それらの操作は残されます。たとえば、以下をexample/Example.smaliとして保存します:
.class public LExample;
.super Ljava/lang/Object;
.method public static add()I
.locals 2
const/4 v0, 0x4
const/4 v1, 0x3
add-int v0, v0, v1
return v0
.end method
.method public static test1()I
.locals 2
new-instance v0, Ljava/lang/Integer;
const/4 v1, 0x1
invoke-direct {v0, v1}, Ljava/lang/Integer;-><init>(I)V
invoke-virtual {v0}, Ljava/lang/Integer;->intValue()I
move-result v0
return v0
.end method
java -jar simplify/build/libs/simplify.jar example -o example.dex を実行し、example.dex を逆アセンブルすると、以下のメソッド本体が得られます:
.method public static add()I
.registers 2
const/4 v0, 0x7
return v0
.end method
.method public static test1()I
.registers 2
const/4 v0, 0x1
return v0
.end method
定数伝播により、加算と intValue() の結果が畳み込まれます。その後、デッドコード除去によって、add-int の未使用の入力と、もはや誰も参照しない Integer が削除されます。そのアロケーション、コンストラクタ、呼び出しはオブジェクトの外部には何も変更しません。
Simplify は Smali ディレクトリ、DEX ファイル、または APK を読み込みます。APK 出力は classes.dex を置き換え、他のすべてのエントリは変更せずに保持し、インストール前に再度署名する必要があります。classes2.dex も含むアーカイブは Multi-DEX archives are not supported で拒否されます。
-v は繰り返すたびにログの詳細度を上げます(-v、-vv)。終了ステータスは、入力が拒否された場合、メソッドの実行に失敗した場合、またはオプティマイザの編集が拒否された場合に 1 になります。--ignore-errors は失敗したメソッドをスキップし、終了ステータス 0 で終了します。スキップされたメソッドは終了ステータスを変更しません。
実行が失敗した場合は、-it で少数のクラスまたはメソッドに限定してください。メソッドが訪問制限を超える場合は、--max-address-visits、--max-call-depth、または --max-method-visits を引き上げてください。解析が JVM ヒープを埋め尽くすようなメソッドは MEMORY_LIMIT でスキップされます。解析するには -Xmx で JVM により多くのヒープを割り当ててください。問題を報告するには、-v または -vv を付けて再度実行し、ログ、完全なコマンド、および APK または DEX またはその SHA-256 ハッシュを添えて issue を作成してください。
./gradlew :demoapp:fatJar :sdbg:fatJar
java -jar demoapp/build/libs/demoapp.jar demoapp/resources
java -jar sdbg/build/libs/sdbg.jar sdbg/resources 'LTest;->addNumbers()V'
デモは demoapp/resources 内の Smali を既知および未知の入力で実行し、それぞれの結果を出力します。デバッガのチュートリアルについては
SDBG を参照してください。
質問、Issue、プルリクエストを歓迎します。バグを報告する際は、APK または DEX(あるいはそのハッシュ) および完全なコマンドを含めてください。
Simplify が所有するプロジェクトのコードは、Apache License, Version 2.0 の下でライセンスされています。同梱の 依存関係、サードパーティのソース、および Android フレームワークのコーパスはそれぞれ独自のライセンスを保持します。 THIRD_PARTY_NOTICES および licenses を参照してください。