一个 Dart AOT 快照分析器。将 libapp.so——Flutter 发布版 APK 中编译后的 Dart 代码——转换为函数名、类布局、调用图、行为信号和可读的伪代码。无需 Dart VM,无需 SDK 编译,无需运行时回退。
分支说明: AOTopsy 是 unflutter 的分支,最初由 Anthony Zboralski 开发。原始的
zboralski/unflutter仓库已不可用(被作者移除);社区延续版本位于KristijanZic/unflutter。原始快照解析器、集群反序列化器、ARM64 反汇编流水线以及 Ghidra/IDA 集成的所有功劳均归原作者所有。AOTopsy 在此基础上扩展了 x86_64 支持、原生反编译器、全程序类型推断、Frida 脚本生成以及全面的文档。
| 输出 | 说明 |
|---|---|
| 函数名 | 每个编译后函数的原始 Dart 名称 |
| 类结构 | 字段名、字节偏移、继承链 |
| 调用图 | 直接(BL)和间接(BLR/分派)调用边及其来源 |
| 字符串引用 | 哪些函数从对象池加载哪些字符串字面量 |
| 行为信号 | 加密、网络、赌博、SIM、位置、WebView、区块链关键词分类 |
| 伪代码 | 来自 ARM64 或 x86_64 机器代码的架构中立反编译输出 |
| Dart 源码导出 | 重建的整项目模块化 .dart 文件,包含类、字段和方法 |
支持 ARM64 和 x86_64。覆盖 Dart 2.10 至 3.13(3.13.2 是当前稳定前沿)——每个已建模版本在两种架构上均可干净解析,参见 COVERAGE.md(93 个样本构建,0 失败)。
AOTopsy 以真实基准进行衡量,而非空口断言。测试套件在每次变更时强制校验两项属性:
| 指标 | 值 | 含义 |
|---|---|---|
| 名称恢复一致率 | 在 44 个真实基准构建上总体 90.2%(最差区间 81.3%,≥ 0.81 门槛下限) | 恢复的函数名与每个构建自身的 ELF .symtab(外部真实基准)进行对比——TestSymtabDifferential。完整的逐构建记分板:BENCHMARK.md(make bench)。 |
| 反编译器语法有效性 | 100% 有效 Dart | 每个输出的伪代码函数均可作为 Dart 解析——TestDecompileQualityCorpus。 |
| 捏造率 | 0% | §2 规则:绝不将猜测的名称、类型或调用目标作为事实输出。未知项如实呈现(indirectCall、<unknown>、dynamic)。 |
真实基准孪生样本是我们无法再分发的真实生产构建,因此这些差分门控在本地运行;公共 CI 验证构建、vet、gofmt、staticcheck、单元测试(乱序)以及跨平台矩阵的覆盖率下限。samples/ 不可再分发且已被 gitignore,因此依赖样本的测试在那里跳过——但仅当语料库完全缺失时;语料库存在但缺少已注册样本则会失败,因为这两者含义相反。此处每个数字的测量方式(真实基准、指标定义、复现):METHODOLOGY.md。发布二进制验证及下方诚实范围参见 SECURITY.md。
make build
./aotopsy libapp.so # full pipeline
./aotopsy doctor libapp.so # quick diagnostic
./aotopsy export-dart --lib libapp.so --out ./lib # reconstruct entire Dart source project
./aotopsy _debug decompile-native --lib libapp.so --find MyClass # find and decompile a function
关于在真实快照上进行五分钟演练,请参阅 DEMO.md;当你拥有原始 APK 且不知从何入手时,请参阅 WORKFLOW.md 了解分步方法论。
AOTopsy 将 Dart AOT 快照视为一种确定性的二进制语法。在给定正确约束(ELF 结构、快照魔数、版本哈希、CID 表、簇编码)的情况下,每个字节都恰好只有一种正确解释。解析器不断施加约束,直到仅剩一种解释存活——没有启发式,没有猜测。
该流水线分阶段运行,每个阶段都是一个从字节到结构化数据的纯函数:
flowchart TD
A[libapp.so] --> B[ELF parse]
B --> C[snapshot region extraction]
C --> D[version detection]
D --> E[cluster alloc<br/>object census]
E --> F[cluster fill<br/>field values, names, strings]
F --> G[instructions table<br/>code ranges, stub boundaries]
G --> H{architecture?}
H -->|ARM64| I[ARM64 disassembly]
H -->|x86_64| J[x86_64 disassembly]
I --> K[CFG + call edges<br/>register provenance]
J --> K
K --> L[type inference<br/>BLR receiver type resolution]
L --> M[signal classification<br/>behavioral keyword matching]
M --> N[JSONL + HTML + DOT<br/>pseudocode output]
两个独立的后端共享相同的前半部分(从 ELF 到簇填充),然后按架构拆分:ARM64 使用 internal/disasm,x86_64 使用 internal/disasm/x86.go。反编译器(internal/decompiler)通过统一的 IR 处理这两种架构。
flowchart LR
subgraph "Shared front half"
A[elfx] --> B[snapshot]
B --> C[cluster]
end
subgraph "ARM64 backend"
C --> D1[disasm ARM64]
D1 --> E1[callgraph]
E1 --> F1[signal]
end
subgraph "x86_64 backend"
C --> D2[disasm x86_64]
D2 --> E2[callgraph]
E2 --> F2[signal]
end
subgraph "Decompiler (both archs)"
C --> G[decompiler IR]
G --> H[pseudocode]
end
flowchart LR
subgraph Blutter
direction TB
B1[libapp.so] --> B2[Compile matching<br/>Dart SDK]
B2 --> B3[Embed Dart VM]
B3 --> B4[Deserialize via<br/>VM internal APIs]
B4 --> B5[Perfect fidelity]
end
subgraph AOTopsy
direction TB
A1[libapp.so] --> A2[Parse binary format<br/>directly]
A2 --> A3[No VM, no SDK]
A3 --> A4[Version-specific<br/>format modeling]
A4 --> A5[Portability + speed]
end
Blutter 嵌入 Dart VM,通过其自身的代码路径反序列化快照。保真度完美,但需要为每个目标版本编译匹配的 Dart SDK——而且它仅支持 ARM64,不支持静态 x86_64。AOTopsy 是唯一静态、版本无关的分析器,带有原生伪代码反编译器和已发布的基准真值准确率。
AOTopsy 直接解析二进制格式。无需 VM,无需 SDK。代价是:Dart 各版本之间的每一处格式变更都必须显式建模。没有运行时来自动处理。
aotopsy libapp.so # disasm + call edges + signal + metadata (ARM64: + Ghidra/IDA)
aotopsy signal libapp.so # same, skip metadata
aotopsy libapp.so --graph # also build call graph DOT files
标志:--out <dir>(默认:<basename>.aotopsy/)、--quiet、--strict、--max-steps <n>、--k <n>(信号上下文深度,默认 2)、--decompile。
--decompile 会将每个函数的 Dart 伪代码写入 <out>/dart/。它默认关闭,因为它会使输出目录大约增大到三倍;每次不带该选项运行时都会提示这一点,因此该功能是可被发现的,而不仅仅是存在。
aotopsy doctor libapp.so # Dart version, pointer size, support status, build features
aotopsy find-libapp --apk app.apk # locate libapp.so inside an APK
将所有类、字段、方法、getter、setter 和构造函数重建为按原始库 URI 映射的模块化 .dart 文件:
aotopsy export-dart --lib libapp.so --out ./reconstructed_lib/ # full project export
aotopsy export-dart --lib libapp.so --out ./lib/ --app-only # filter out core/flutter framework
aotopsy export-dart --lib libapp.so --out ./lib/ --filter Auth # targeted export by name
直接从二进制机器指令生成干净、符合习惯的 Dart 代码:
for-in 迭代器、while、for、try-catch-finally,并精确界定 PC 范围。_SuspendState 状态机展开为线性的 await future 和 await for。(item) => process(item)。String、int、UserModel),无需运行实时 VM。?.、??、??=)、级联(..)、Set/List/Map 字面量、字符串插值("${a}${b}")。aotopsy _debug decompile-native --lib libapp.so --find MyClass # locate by name
aotopsy _debug decompile-native --lib libapp.so --func 0x1a92728 # one function at a VA
aotopsy _debug decompile-native --lib libapp.so --from-main --out out/ # reachability from app entry
aotopsy _debug decompile-native --lib libapp.so --all --filter MyClass # bulk, filtered
警告:在没有设置较小的 --max 的情况下使用 --all,在真实应用上可能需要约 64GB 内存。建议优先使用 --find/--func/--from-main。
aotopsy ghidra libapp.so # headless Ghidra with metadata injection
aotopsy ida libapp.so # headless IDA via idalib
两者都会拒绝 x86_64 输入。对于 x86_64 伪代码,请使用 decompile-native。
aotopsy _debug decompile-native --lib libapp.so --func 0x1a92728 --gen-frida --gen-frida-out hooks.js
frida -U -f com.example.app -l hooks.js --no-pause
完整指南请参阅 FRIDA.md。
aotopsy _debug strings --lib libapp.so --find "X-Signature" --xref # which function loads this string?
aotopsy _debug ffi-trace --lib libapp.so --filter MyClass # dart:ffi call sites
aotopsy _debug dispatch-table --lib libapp.so --filter MyClass # dispatch table entries
aotopsy _debug fingerprint --lib libapp.so # build-id and version markers
aotopsy _debug funcdiff --old old.so --new new.so # function set diff
aotopsy _debug symbolmap --stripped lib.so --unstripped debug.so # resolve stripped targets