B(l)utter

Инструмент для реверс-инжиниринга мобильных приложений Flutter путём компиляции Dart AOT Runtime

В настоящее время приложение поддерживает только Android libapp.so (только arm64). Также приложение в настоящее время работает только с последними версиями Dart.

По поводу наиболее приоритетных недостающих функций см. TODO

Настройка окружения

Это приложение использует библиотеку форматирования C++20. Требуется очень свежий компилятор C++, такой как g++>=13, Clang>=16.

Я рекомендую использовать ОС Linux (тестировалось только на Debian sid/trixie), так как её легко настроить.

Debian Unstable (gcc 13)

ПРИМЕЧАНИЕ: Используйте ТОЛЬКО версию Debian/Ubuntu, которая предоставляет gcc>=13 из своего основного репозитория. Использование портированного gcc на старой версии Debian/Ubuntu не работает.

• Установите инструменты сборки и зависимости

apt install python3-pyelftools python3-requests git cmake ninja-build \
    build-essential pkg-config libicu-dev libcapstone-dev

Windows

• Установите git и python 3
• Установите последнюю версию Visual Studio с компонентами "Разработка классических приложений на C++" и "Инструменты CMake для C++"
• Установите необходимые библиотеки (libcapstone и libicu4c)

python scripts\init_env_win.py

• Запустите "Командную строку собственных инструментов x64"

macOS Sequoia

• Установите XCode
• Установите необходимые инструменты

brew install cmake ninja pkg-config icu4c capstone
pip3 install pyelftools requests

macOS Ventura и Sonoma (clang 16)

• Установите XCode
• Установите clang 16 и необходимые инструменты

brew install llvm@16 cmake ninja pkg-config icu4c capstone
pip3 install pyelftools requests

Использование

Извлеките каталог "lib" из файла apk

python3 blutter.py path/to/app/lib/arm64-v8a out_dir

Скрипт blutter.py автоматически определит версию Dart из движка Flutter и вызовет исполняемый файл blutter для получения информации из libapp.so.

Если исполняемый файл blutter для требуемой версии Dart не существует, скрипт автоматически загрузит исходный код Dart и скомпилирует его.

Обновление

Вы можете использовать git pull для обновления и запустить blutter.py с опцией --rebuild для принудительной пересборки исполняемого файла

python3 blutter.py path/to/app/lib/arm64-v8a out_dir --rebuild

Выходные файлы

• asm/* ассемблерные листинги libapp с символами
• blutter_frida.js шаблон скрипта Frida для целевого приложения
• objs.txt полный (вложенный) дамп объектов из пула объектов
• pp.txt все объекты Dart в пуле объектов

Каталоги

• bin содержит исполняемые файлы blutter для каждой версии Dart в формате "blutter_dartvm<ver>_<os>_<arch>"
• blutter содержит исходный код. Требуется сборка с библиотекой Dart VM
• build содержит проекты сборки, которые можно удалить после завершения процесса сборки
• dartsdk содержит копию Dart Runtime, которую можно удалить после завершения процесса сборки
• external содержит сторонние библиотеки только для Windows
• packages содержит статические библиотеки Dart Runtime
• scripts содержит скрипты Python для получения/сборки Dart

Генерация решения Visual Studio для разработки

Я использую Visual Studio для разработки Blutter на Windows. Опция --vs-sln может быть использована для генерации решения Visual Studio.

python blutter.py path\to\lib\arm64-v8a build\vs --vs-sln

TODO

• Более глубокий анализ кода
  • Аргументы функций и тип возвращаемого значения
  • Некоторый псевдокод для шаблонов кода
• Генерация лучшего скрипта Frida
  • Больше внутренних классов
  • Модификация объектов
• Запутанное приложение (всё ещё отсутствует много функций)
• Чтение бинарного файла iOS
• Входной файл в формате apk или ipa