pyjadx
JPypeを介したJADXのPythonバインディング。PythonからAndroid APKおよびDEXファイルをJavaソースに逆コンパイルします。
from pyjadx import Jadx
with Jadx("app.apk") as jadx:
for cls in jadx.classes:
print(cls.full_name)
print(cls.code)
pyjadx を使う理由
JADXは主要なオープンソースAndroidデコンパイラであり、DalvikバイトコードからクリーンなJava/Kotlinソースを生成し、クラス階層、ジェネリクス、例外処理、アノテーションを保持します。pyjadxはこれをサブプロセスオーバーヘッドなしでPythonにもたらします。JADXはJPypeを介してインプロセスで実行されます。
インストール
要件: JDK 11以上(JADX JARは初回使用時に自動的にダウンロードされます)。
クイックスタート
from pyjadx import Jadx
with Jadx("app.apk") as jadx:
# All top-level classes (inner classes via cls.inner_classes)
for cls in jadx.classes:
print(cls.full_name, len(cls.methods), "methods")
# Search by fully qualified name
main = jadx.search_class("com.example.MainActivity")
if main:
print(main.code)
# Method-level decompilation
for method in main.methods:
print(f"{method.name}: {method.code}")
# Cross-references
for method in main.methods:
print(f"{method.name} called by: {[c.name for c in method.callers]}")
# Package navigation
for pkg in jadx.packages:
print(pkg.name, len(pkg.classes), "classes")
対応入力形式
| 形式 | 例 |
|---|
| APK | Jadx("app.apk") |
| DEX | Jadx("classes.dex") |
| Multi-DEX APK | 透過的に処理 — すべてのクラスがマージされます |
APIリファレンス
Jadx(path, *, threads=None, mode="auto", code_cache=False)
メインエントリポイント。コンテキストマネージャとして使用するか、手動でload()/close()を呼び出します。
プロパティ:
メソッド:
JavaClass
JavaMethod
JavaField
JavaPackage
エスケープハッチ
すべてのラッパーは、.javaを介して基盤となるJADX Javaオブジェクトを公開します。これにより、まだラップされていないJADX APIを呼び出すことができます。
with Jadx("app.apk") as jadx:
cls = jadx.search_class("com.example.Foo")
# Call JADX Java API directly
code_info = cls.java.getCodeInfo()
JVM共存
pyjadxは同じプロセス内で他のJPypeコンシューマ(例:PyGhidra)と共存します。JVMがすでに実行中の場合は、pyjadx.start()が既存のクラスパスにJADX JARを追加します。そうでない場合は、新しいJVMを起動します。
import pyghidra
pyghidra.start() # starts JVM for Ghidra
import pyjadx
pyjadx.start() # adds JADX JARs to existing JVM — no conflict
設定
カスタムJADXインストール:
# Via environment variable
# export JADX_HOME=/opt/jadx
# Or at runtime
import pyjadx
pyjadx.start(jadx_home="/opt/jadx")
JARキャッシュ: JADX JARは初回使用時にMaven Centralから自動ダウンロードされ、~/.pyjadx/jars/<version>/にキャッシュされます。
ライセンス
MIT