Интеграция Rust-кода в мобильное приложение через FFI

Интеграция Rust-кода в мобильное приложение через FFI

Rust в мобильных проектах появляется в конкретных сценариях: криптографическая логика, парсинг бинарных протоколов, высоконагруженная обработка данных, алгоритмы где нужна гарантия memory safety без GC-пауз. Discord использует Rust для мобильного клиента (синхронизация состояния), Signal — для криптографии (libsignal написан на Rust и подключается к iOS и Android через FFI).

Как устроена интеграция

Rust компилируется в статическую библиотеку (.a на iOS, .a/.so на Android) с C ABI через extern "C". На стороне мобильного приложения биндинги генерируются автоматически или пишутся вручную.

Cargo конфигурация. Cargo.toml:

[lib]
crate-type = ["staticlib", "cdylib"]

staticlib — для iOS (статическая линковка), cdylib — для Android (динамическая .so). Cross-компиляция через cargo-ndk (Android) и стандартный Cargo с iOS targets.

Targets для Android:

cargo ndk -t arm64-v8a -t x86_64 -o ./jniLibs build --release

Targets для iOS:

cargo build --target aarch64-apple-ios --release
cargo build --target aarch64-apple-ios-sim --release
cargo build --target x86_64-apple-ios --release
lipo -create target/x86_64-apple-ios/release/libmylib.a \
     target/aarch64-apple-ios-sim/release/libmylib.a \
     -output libmylib-sim.a

Затем xcodebuild -create-xcframework объединяет device и simulator варианты.

Генерация биндингов: uniffi vs cbindgen

mozilla/uniffi-rs — рекомендуем для большинства проектов. Rust-интерфейс описывается в .udl файле (UDL — Universal Definition Language), uniffi-bindgen генерирует Kotlin-классы для Android и Swift-файлы для iOS. Результат — нативный API без ручного написания JNI или Objective-C.

// mylib.udl
namespace mylib {
    sequence<u8> encrypt(sequence<u8> data, string key);
};

Генерирует mylib.kt с fun encrypt(data: List<UByte>, key: String): List<UByte> и mylib.swift с func encrypt(data: [UInt8], key: String) -> [UInt8].

cbindgen — генерирует C-заголовочный файл из Rust. Подходит если нужен тонкий C-слой, а биндинги к Swift/Kotlin пишутся вручную или через другой инструмент. Больше контроля, больше ручной работы.

Потокобезопасность и memory management

На границе Rust↔мобильный нужно явно управлять временем жизни объектов. Если Rust-функция возвращает указатель на heap-аллоцированную структуру — мобильный код получает Long (Android) или UnsafeRawPointer (iOS). Уничтожение объекта — через явный free_object(ptr) на Rust-стороне, вызванный из finalize()/deinit. Забыть вызвать free_* — memory leak. Uniffi автоматизирует это через Arc reference counting.

Rust паника (panic!) через FFI — undefined behavior. Весь FFI-код оборачиваем в std::panic::catch_unwind или используем #[no_panic] аннотации для критичных путей.

Async Rust в FFI. tokio runtime можно создать внутри Rust-кода: Runtime::new().unwrap().block_on(async { ... }). Это синхронный вызов с точки зрения FFI, но асинхронный внутри Rust. Для настоящего async взаимодействия — callback-based API или uniffi-rs с поддержкой async (экспериментально в uniffi 0.25+).

Кейс. Мессенджер с end-to-end шифрованием: криптографическое ядро на Rust (Double Ratchet алгоритм, X3DH key exchange) через uniffi. Android: Kotlin вызывает RatchetSession.encrypt(plaintext) — под капотом FFI к Rust. iOS: Swift вызывает RatchetSession.encrypt(plaintext:). Один Rust-код — идентичная логика на обеих платформах. Unit-тесты — на Rust (cargo test), интеграционные тесты — на Kotlin и Swift. CI: GitHub Actions, матрица из 4 target'ов, сборка xcframework и .aar как артефакты.

Отладка и профилирование

Rust-код в мобильном приложении отлаживается сложнее нативного: LLDB подключается к процессу, символы загружаются из .dSYM (iOS) или .so с debug info (Android). cargo build без --release сохраняет debug symbols. Firebase Crashlytics показывает стек до Rust-фрейма если символизация настроена.

AddressSanitizer для Rust через RUSTFLAGS="-Z sanitizer=address" — находит use-after-free и buffer overflows в нативном коде до попадания в продакшен.

Сроки

Стоимость рассчитывается индивидуально. Ключевые факторы: сложность Rust API, требования к производительности, необходимость поддержки обеих платформ.