BlutterAndroid — App 内集成 Blutter 的 Flutter 逆向工程工具

一个 Android App：在设备本地对 Flutter 应用的 libapp.so 做逆向分析 （反汇编 + 对象池 dump + Frida 脚本生成），支持 Dart 2.14 ~ 3.13 共 70 个版本。中间部分版本不支持，详细可以看支持版本一节。

核心逆向引擎是 blutter。 本项目将其交叉编译为 Android bionic 版 PIE 可执行文件，以 jniLibs 形式集成进 App， 由 App 在运行时 execve 调用（子进程设 LD_LIBRARY_PATH）。

安装即用（开箱即用）：App 安装包已内置全部 70 个版本的 blutter 可执行文件， 无需在设备上现场从源码编译，也无需配置 chroot / proot / Termux 等容器环境 —— 安装后直接打开即可分析，全程无 root、无额外依赖。

特性

• 安装即用：预编译二进制随 App 分发，无需现场编译、无需 chroot / proot 容器，装好即用。
• 版本覆盖较全：libblutter_<版本>.so 每版本一个，共 70 个。
• 无需 root：产物放 jniLibs/arm64-v8a/，由 PackageManager 提取到可执行目录。
• 跨平台构建：Linux / Windows 同一套脚本，Windows 自动切换 NDK toolchain 与命令后缀。
• 自包含：Dart SDK 源码、静态库均按需拉取/构建，不进仓库。

目录结构

BlutterAndroid/
├── app/                       # Android App（Kotlin）
│   └── src/main/java/com/ace77505/flutter/
├── blutter/                   # 逆向引擎（blutter fork + 构建脚本）
│   ├── blutter/src/           #   blutter C++ 源码（含 fork 改动）
│   ├── *.py                   #   构建/打包脚本
│   ├── patches/               #   上游补丁 + fork 改动留档
│   ├── ndk_src/               #   第三方源码归档（capstone / icu）
│   └── dartsdk/ packages/ bin/ ndk_out/   # 生成物，已 gitignore
├── BLUTTER_ANDROID_BUILD.md   # ★ 编译与部署详解
├── BLUTTER_INTEGRATION.md     #   App 侧集成说明
├── EXTERNAL_SO_ANALYSIS.md    #   外部 so 分析笔记
└── THIRD_PARTY_NOTICES.md     #   第三方许可声明

构建

普通使用无需构建（见上文「安装即用」）；本节面向需要自行编译二进制或扩展新 Dart 版本的用户。

编译环境、依赖、脚本与平台注意事项见 BLUTTER_ANDROID_BUILD.md。

快速概览（Windows 需设 NDK 与 CMAKE_GENERATOR=Ninja）：

cd blutter
python patch_all_snapshot.py          # 降级 snapshot 校验为 warning
python ndk_out/icu_host_build.py      # 预构建 ICU / capstone（一次性）
python ndk_out/icu_android_build.py --shared
python ndk_out/capstone_android_build.py
python build_dartvm_bionic.py         # 编译 dartvm 静态库
python build_blutter_bionic.py        # 编译 blutter 可执行文件
python build_jnilibs_bionic.py        # 汇总为 jniLibs

App 侧集成（SAF 输出目录、execve 调用）见 BLUTTER_INTEGRATION.md。

支持版本

版本段	状态	备注
2.14.1 / 2.14.2 / 2.14.4	✅	no-analysis（仅 dump 对象池）
2.15.0 / 2.15.1	✅
2.16.0 ~ 2.18.6	✅
2.19.6	✅
3.4.0 ~ 3.13.4	✅	含 3.13 移植
3.0.x ~ 3.3.x	❌	见文档「不兼容」
2.13.x 及更早	❌	Dart <2.14 无指针压缩，结构性不兼容

预编译二进制

App 安装包（APK）已内置全部 70 个版本的 libblutter_*.so（位于 jniLibs/arm64-v8a/）， 因此安装即可用，无需另行下载。

本源码仓库不含这些体积较大的二进制；如需单独获取（或 libdartvm*.a 静态库）， 可通过 GitHub Releases 附件分发。

许可

本项目采用 MIT 许可（见 LICENSE）。

整合的第三方组件（blutter、Dart SDK、Capstone、ICU、Android NDK 等） 版权归各自作者，许可与改动说明见 THIRD_PARTY_NOTICES.md。 其中 blutter/ 源自 worawit/blutter（MIT）， 本 fork 的改动全量留档于 blutter/patches/fork-local-changes.patch。