Files
voidandClaude Sonnet 4.6 c29e425996 chore(agents): 添加 Android 逆向工程 skill
包含 APK 反编译、API 调用提取、调用链分析、Kotlin 名称恢复等参考文档,
以及 jadx/fernflower 相关脚本与第三方域名过滤列表。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-11-08 21:15:24 +08:00

3.0 KiB

jadx CLI Reference

Basic Usage

jadx [options] <input-file>

Input can be an .apk, .jar, .aar, .dex, or .zip file.

Key Options

Option Description
-d <dir> Output directory for decompiled sources
--deobf Enable deobfuscation — renames obfuscated classes/methods to readable names
--show-bad-code Show partially decompiled code instead of error comments
--no-res Skip resource decoding — faster when you only need code
--no-src Skip source decompilation — only decode resources
--export-gradle Generate a Gradle project structure (useful for importing into IDE)
-e Same as --export-gradle
--threads-count <N> Number of processing threads (default: CPU count)
-Xmx<size> Set maximum Java heap (e.g., -Xmx4g for large APKs)

Decompiling Different File Types

APK (Android Application Package)

jadx -d output-dir app.apk

Produces:

  • output-dir/sources/ — Decompiled Java source files
  • output-dir/resources/ — Decoded resources (AndroidManifest.xml, layouts, drawables, etc.)

JAR (Java Archive)

jadx -d output-dir library.jar

Useful for analyzing third-party libraries bundled within an APK.

AAR (Android Archive)

jadx -d output-dir library.aar

AAR files contain both compiled code and Android resources. jadx handles them directly.

Handling Obfuscated Code

Apps built with ProGuard or R8 produce obfuscated bytecode with single-letter class and method names.

Strategies

  1. Use --deobf to generate readable replacement names:

    jadx --deobf -d output-dir app.apk
    

    jadx creates a mapping file at output-dir/deobf-mapping.txt that maps original obfuscated names to generated names.

  2. Use the ProGuard mapping file if available (sometimes shipped in the APK under assets/ or obtainable from build artifacts):

    jadx --deobf-map mapping.txt -d output-dir app.apk
    
  3. Focus on string constants and API calls rather than class names when navigating obfuscated code. URL strings, annotation values, and library classes are not obfuscated.

jadx-gui

For interactive exploration, use the GUI version:

jadx-gui app.apk

Features:

  • Full-text search across all decompiled sources
  • Click-through navigation (jump to definition)
  • Deobfuscation with live renaming
  • Smali view alongside Java

jadx-gui is included in the same distribution as the CLI tool.

Common Workflows

Code-only decompilation (fastest)

jadx --no-res --show-bad-code -d output app.apk

Full decompilation with deobfuscation

jadx --deobf --show-bad-code -d output app.apk

Export as Gradle project for IDE import

jadx -e -d output app.apk
# Then open output/ in Android Studio or IntelliJ

Decompile a specific DEX from a multi-dex APK

Extract the APK (it's a ZIP), then target individual DEX files:

unzip app.apk -d extracted/
jadx -d output extracted/classes2.dex