Rust 版本: 本项目已用 Rust 1:1 重写为 rust_ASC。Rust 版本快 10 倍,并支持完整的 APK 反编译:使用 16 个线程,它仅需 4 秒即可反编译一个 383 MB 的 APK。
如果你的工作流使用 Python 编写,你可以继续集成此项目;它仍然是目前可用的最快的 Python Android 反编译器。如果你只需要一个二进制文件,请使用 rust_ASC。
ASC 和 rust_ASC 将并行维护,因此用户可以选择最适合其工作流的集成方式。
在反编译大型 Android APK 时,标准流程就是等待。我们等待工具消耗数 GB 的内存、完全展开产物,并花费数十分钟构建沉重的全局索引和交叉引用……所有这些只是为了确保后续的代码搜索足够快,但矛盾就在这里。编译后的产物本身已经高度结构化,现代反编译器却从不利用这一点,它们在已经结构化的数据之上浪费大量时间和内存来重建一个臃肿的代码关系数据库。这种工程方法违背常理。当我可以直接从 APK 中以毫秒级提取任何代码关系时,这种预处理还有任何价值吗?
我们没有强迫反编译器进行繁重的预处理,而是选择将编译后的产物直接作为数据库来查询。我们构建了一个无状态、零开销的引擎,可按需在毫秒级提取和搜索代码。在本次简报中,我们将探讨绕过传统瓶颈所需的底层工程实现。我们将演示如何通过直接在 Deflate 比特流内部进行探测来放弃完全展开,构建密集的 Huffman 查找表以在不触及无关数据块的情况下提取核心元数据。此外,我们将解释 R8 编译器的优化细节,特别是确定性的常量重定位和指令去重如何留下高度集中的物理布局,我们将这种编译器行为武器化,以执行闪电般的跨 DEX 代码搜索。为了将这些原始字节码偏移映射回方法,我们设计了一个 O(1) 指令定位原语,在不构建沉重映射表的情况下实现常数时间的方法解析。最后,在命中目标时,Droid ASC 仅提取特定的字节码及其依赖项,完全在内存中动态重建一个最小且自洽的 DEX,以实现即时反编译。
我们将针对一个 352MB 的商业 APK 现场演示这一架构。Droid ASC 仅使用 141MB 内存,在 1.79 秒内执行全局交叉引用搜索,并在 177 毫秒内反编译目标类。通过将产物视为只读数据库并以零预处理方式运行,我们让反编译器回归其核心本质。它不再是一个臃肿的索引工具,而是一个闪电般快速的按需反编译引擎,从根本上重新定义了我们分析编译代码的方式。

https://github.com/user-attachments/assets/4c4a6813-8561-490c-a573-ef113da861b6
原始绝对值,使用 10 个线程在四个大小递增的 APK 目标上测量:
全局字符串交叉引用搜索
| 工具 | TelegramX (59MB) | WhatsApp (130MB) | Grab (228MB) | Lark (352MB) |
|---|---|---|---|---|
| ASC | 322ms | 418ms | 806ms | 1.597s |
| JADX | 20s | 32s | 2m14s | 8m2s |
在全局字符串交叉引用搜索方面,ASC 比 JADX 快 62 倍到 302 倍。
单类反编译
| 工具 | TelegramX (59MB) | WhatsApp (130MB) | Grab (228MB) | Lark (352MB) |
|---|---|---|---|---|
| ASC | 157ms | 141ms | 165ms | 303ms |
| JADX | 6s | 15s | 37s | 1m32s |
在单类反编译方面,ASC 比 JADX 快 38 倍到 304 倍。
CLI 内存使用
| 工具 | TelegramX (59MB) | WhatsApp (130MB) | Grab (228MB) | Lark (352MB) |
|---|---|---|---|---|
| ASC | 36MB | 36MB | 58MB | 141MB |
| JADX | 1,016MB | 2.1GB | 7.1GB | 13.2GB |
在 CLI 操作下,ASC 的内存占用比 JADX 少 28 倍到 125 倍。
磁盘缓存使用情况
| 工具 | TelegramX (59MB) | WhatsApp (130MB) | Grab (228MB) | Lark (352MB) |
|---|---|---|---|---|
| ASC | 0MB | 0MB | 0MB | 0MB |
| JADX | 119MB | 30MB | 127MB | 322MB |
ASC 完全驻留内存,磁盘缓存为零,而 JADX 最多写入 322MB。
注意:JADX 在最大的目标(Lark)上进行全局搜索时内存耗尽(搜索进度约 49%),而 ASC 完成了每一个目标。
正如基准测试所示,ASC 在约 50MB 的 APK 上比 JADX 快 62 倍,在约 300MB 的 APK 上快 302 倍,且内存占用极小。智能体可以搭配 ASC 一次性分析数十甚至数百个 APK,即使在性能较弱的机器上也是如此。JADX MCP 在这方面则较为吃力:仅 JADX 本身就需要数 GB 内存用于预加载,这使得在数百个 APK 之间切换变得不切实际。
# from PyPI
pip install droidasc
# or from source
pip install .
安装完成后,droidasc CLI 命令即可全局使用:
usage: droidasc [-h] {getclass,disassemble,listclass,getmanifest,findrefs} ...
ASC tooling entry (v0.1.2.post1).
positional arguments:
{getclass,disassemble,listclass,getmanifest,findrefs}
getclass Locate the target class in APK, extract one DEX in
memory, then decompile.
disassemble Extract a class, rebuild a small DEX, then disassemble
it with dadguard.
listclass List classes across all DEX entries; use --prefix to
filter by package/class prefix.
getmanifest Decode AndroidManifest.xml from APK and print it as
XML.
findrefs Find code references for string/type/method/field
across all DEX entries in APK.
options:
-h, --help show this help message and exit
examples:
droidasc app.apk --gui
droidasc getclass app.apk Lcom/poc/Main; -o Main.java
droidasc getclass app.apk com.poc.Main --threads 16
droidasc disassemble app.apk Lcom/poc/Main; -o Main.smali
droidasc disassemble app.apk com.poc.Main --debug
droidasc disassemble app.apk com.poc.Main --debuginfo
droidasc disassemble app.apk com.poc.Main --method 'run(I)V'
droidasc listclass app.apk
droidasc listclass app.apk -o classes.txt
droidasc listclass app.apk --prefix com.poc
droidasc getmanifest app.apk
droidasc getmanifest app.apk -o AndroidManifest.xml
droidasc findrefs app.apk string token -o string_refs.txt
droidasc findrefs app.apk type com.poc.Main
droidasc findrefs app.apk method onCreate --class com.poc.Main
droidasc findrefs app.apk method notify --class MainActivity --fuzzy-class -o method_refs.txt
droidasc findrefs app.apk field apiKey -o field_refs.txt
droidasc findrefs app.apk extends java.lang.Object
droidasc findrefs app.apk extends android.app.Activity -o subclasses.txt
droidasc findrefs app.apk impl android.os.IInterface -o impls.txt
-V/--version 打印已安装包的版本。
findrefs 在所有 DEX 条目中搜索代码引用(字符串/类型/方法/字段);-o 将结果写入指定文件而非标准输出,--threads N 控制工作线程池。extends/impl 分别用于定位继承目标类或实现目标接口的类。
listclass 按 APK/DEX 定义顺序打印 Dalvik 类描述符,每行一个。使用 -o 时,输出写入指定文件而非标准输出。--prefix com.poc 按 Lcom/poc 过滤;已规范化的前缀(如 Lcom/poc)保持不变。
disassemble 接受与 getclass 相同的点分或 Dalvik 类格式。它从 APK 中提取目标类,在内存中重建一个小型 DEX,并使用 dadguard 反汇编重建后的 DEX。--debug 启用计时输出和指令偏移注释;--debuginfo 启用 DEX .line 和局部变量指令。--method 'run(I)V' 将输出限制为一个精确的方法签名;仅提供方法名会被拒绝。所有支持 -o 的命令在省略 -o 时写入标准输出。
你仍可以像以前一样使用 python main.py —— 它会委托给同一个入口点。
| 赞助者 | 金额 |
|---|---|
| HTTChina | 5000¥ |
| c01ns | 11.9¥ |
| gguowang AND cococount | 2¥ |
| Ylarod | 50.11¥ |
感谢所有赞助者的支持!
ASC 的构建初衷是真正帮助每个人改进逆向工程工作流程——从加速繁琐的部分到让不可能的事情变得习以为常。
感谢 Androguard 项目为 Droid ASC 提供 Android 逆向工程和 DEX 分析基础。