React Native нативний модуль: New Architecture, JSI, TurboModules

React Native Library з нативним модулем: New Architecture, JSI, TurboModules

Розробка мобільного додатку часто впирається у пропрієтарні SDK вендора — інтеграція з біометрією, камерами, MDM-системами. Готові бібліотеки з React Native Community рідко покривають такі кейси, і доводиться писати нативний модуль з нуля. Ми займаємося цим більше 5 років, реалізували понад 10 проєктів з нативними модулями під iOS та Android. Наш досвід показує: правильний вибір архітектури скорочує час розробки в 2–3 рази.

Old Architecture vs New Architecture: принципова різниця

New Architecture використовує JSI (JavaScript Interface) — прямий C++ binding між JS двигуном (Hermes) і нативним кодом. TurboModules завантажуються ліниво і викликаються синхронно. Для високочастотних операцій (кожен кадр анімації, real-time audio processing) це критично: різниця в продуктивності досягає 5–10 разів. Бібліотека повинна підтримувати обидва варіанти через codegen специфікацію.

Чому New Architecture швидше?

Стара архітектура (Bridge) працює асинхронно через серіалізацію JSON. Виклик нативного методу: JavaScript → JSON serialization → Bridge queue → deserialization → Java/ObjC. Це додає ~1-5 мс на кожен виклик і робить неможливим синхронний доступ до нативного коду. New Architecture використовує JSI (JavaScript Interface) — прямий C++ binding між JS двигуном (Hermes) і нативним кодом. TurboModules завантажуються ліниво і викликаються синхронно. Для високочастотних операцій (кожен кадр анімації, real-time audio processing) це критично.

React Native 0.73+ включає New Architecture за замовчуванням. Бібліотека повинна підтримувати обидва варіанти через codegen специфікацію.

Як створити бібліотеку через create-react-native-library

npx create-react-native-library@latest my-module — стандартний scaffold. Генерує структуру:

my-module/
  android/src/main/java/…/MyModule.kt
  ios/MyModule.mm (Objective-C++ для JSI bridge)
  src/index.tsx        — TypeScript API
  src/NativeMyModule.ts — codegen spec

Codegen специфікація

TypeScript-файл описує контракт, за яким codegen генерує C++ glue code:

// NativeMyModule.ts
import type { TurboModule } from 'react-native';
import { TurboModuleRegistry } from 'react-native';

export interface Spec extends TurboModule {
  multiply(a: number, b: number): Promise<number>;
  getDeviceId(): string; // синхронний метод — тільки в New Architecture
}

export default TurboModuleRegistry.getEnforcing<Spec>('MyModule');

getEnforcing кидає помилку при старті, якщо нативний модуль не зареєстровано — краще, ніж мовчазний undefined.

Реалізація на Android: Kotlin + ReactPackage

class MyModule(reactContext: ReactApplicationContext) :
    NativeMyModuleSpec(reactContext) {

    override fun getName() = NAME

    override fun multiply(a: Double, b: Double): Promise<Double> {
        return Promise.resolve(a * b)
    }

    override fun getDeviceId(): String {
        return Settings.Secure.getString(
            reactApplicationContext.contentResolver,
            Settings.Secure.ANDROID_ID
        )
    }

    companion object {
        const val NAME = "MyModule"
    }
}

NativeMyModuleSpec — абстрактний клас, згенерований codegen з TypeScript специфікації. Якщо метод не реалізовано — помилка компіляції, а не рантайм-краш. Це ключова перевага New Architecture.

ReactPackage реєструє модуль:

class MyPackage : ReactPackage {
    override fun createNativeModules(context: ReactApplicationContext) =
        listOf(MyModule(context))
    override fun createViewManagers(context: ReactApplicationContext) = emptyList<ViewManager<*, *>>()
}

Реалізація на iOS: Objective-C++ bridge

Для New Architecture iOS-реалізація пишеться на Objective-C++ (.mm) або Swift з ObjC-обгорткою. Swift нативно не підтримує JSI без bridge, тому .mm файл з #import <React/RCTUtils.h> залишається обов'язковим.

// MyModule.mm
#import "MyModule.h"
#import <React/RCTUtils.h>

@implementation MyModule

RCT_EXPORT_MODULE()

- (NSString *)getDeviceId {
    return [[[UIDevice currentDevice] identifierForVendor] UUIDString];
}

@end

Для синхронних методів в Old Architecture: RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD — працює, але блокує JS thread. В New Architecture синхронність через JSI не блокує JS thread — кардинально інша модель.

Нативні View компоненти та підтримка Expo

Якщо задача — кастомний нативний View (наприклад, SDK карт, кастомний відеоплеєр), використовуємо ViewManager на Android / RCTViewManager на iOS. New Architecture вводить Fabric для нативних компонентів — аналог TurboModules для в'ю. Codegen генерує ComponentDescriptor по TypeScript специфікації з codegenNativeComponent.

Для додатків на Expo managed workflow нативний модуль вимагає Expo Modules API замість голого React Native. npx create-expo-module генерує правильний scaffold. ExpoModule реєструється автоматично без ReactPackage — Expo Autolinking знаходить модуль по package.json.

Які типові помилки виникають?

Що входить у розробку нативного модуля під ключ

Наші інженери (більше 5 років досвіду в React Native) виконують:

• Аналіз вимог і проєктування API модуля
• Реалізацію нативного коду на Kotlin та Objective-C++/Swift
• Кодогенерацію TypeScript-специфікацій та інтеграцію з New Architecture
• Написання тестів (unit + integration) для обох платформ
• Збірку та публікацію в npm/Expo registry
• Документацію модуля та приклади використання
• Підтримку після релізу (виправлення багів, оновлення під нові версії RN)

Терміни та гарантії

Вартість розраховується індивідуально. Оцінимо ваш проєкт — зв'яжіться з нами для консультації.

Використання codegen виключає помилки компіляції в рантаймі. Кожен модуль проходить тестування на реальних пристроях (iOS 15+ та Android 10+). Надаємо сертифікат сумісності з останніми версіями React Native. Гарантуємо безкоштовну підтримку протягом 30 днів після передачі.

За даними офіційної документації React Native, JSI забезпечує зниження затримки на виклик з 1-5 мс до <0.1 мс.

Замовте розробку нативного модуля — отримайте консультацію наших інженерів.

Як обрати кроссплатформну розробку: Flutter, React Native чи KMM?

Коли потрібен додаток на iOS та Android, а бюджет на дві окремі команди — постає питання вибору фреймворку. Ми бачили проєкти, де неправильний вибір призводив до переписування через півроку. Кожен інструмент диктує свій стек і накладає обмеження. Перед стартом проводимо аудит технологічних вимог та експертизи команди.

Три основні гравці зараз: Flutter, React Native та Kotlin Multiplatform Mobile. Вони вирішують різні проблеми і погано порівнюються в лоб. Нижче розберемо, як обрати оптимальний варіант під ваш проєкт.

Кроссплатформна розробка: основні критерії вибору

Перше — зрозуміти, що саме ви будете робити: багатий брендовий UI чи нативний look and feel? Друге — якою мовою володіє команда. Якщо це JavaScript/TypeScript — React Native дає швидкий старт. Якщо Dart — Flutter. Якщо хочуть оптимізувати логіку — KMM. Третє — які нативні API будуть задіяні: камера, Bluetooth, фонові оновлення. Для деяких стеків інтеграція складніша.

Як ми обираємо кроссплатформний фреймворк?

1. Аналіз вимог — список нативних API, необхідність автономної роботи, брендовий UI або стандартний.
2. Оцінка команди — експертиза в Dart, JavaScript/Kotlin, наявність iOS-розробника.
3. Прототип (proof-of-concept) — реалізація критичного сценарію на обраному стеку за 2–3 дні.
4. Фінальне рішення — на основі бенчмарків продуктивності та вартості підтримки.

Чим відрізняються Flutter і React Native?

Це порівняння, яке реально впливає на вибір. Розберемо за конкретними технічними характеристиками.

Модель рендерингу

Flutter рендерить UI самостійно через Impeller (замінив Skia починаючи з версії 3.10). Платформа надає лише canvas — Flutter малює кожен піксель сам. Це означає:

• Піксельна точність на всіх платформах. Один і той же віджет виглядає однаково на iOS та Android — добре для брендових додатків, погано якщо потрібно виглядати «нативно» на кожній платформі.
• Немає залежності від версії ОС. Material 3 у Flutter працює однаково на Android 8 та Android 14. Системні компоненти Android не беруть участі.
• Platform channels для нативного коду. Доступ до камери, Bluetooth, NFC — через MethodChannel або EventChannel. flutter_camera, flutter_blue_plus — це обгортки над platform channels.

React Native використовує нативні компоненти платформи. <View> на iOS — це UIView. <Text> — це UILabel. Це означає:

• Нативний look and feel без додаткових зусиль.
• New Architecture (Fabric + TurboModules) з JSI прибрала JSON-міст між JS та нативним кодом. Синхронні виклики працюють без серіалізації. Це критично для анімацій та жестів.
• React Native Reanimated 3 запускає worklets на UI thread — анімації в 60/120 fps без блокування JS thread.

Продуктивність на практиці

Для більшості бізнес-додатків різниця в продуктивності між Flutter та React Native New Architecture непомітна користувачеві. Різниця з’являється в граничних випадках.

Flutter повільніший при взаємодії з платформеними API через platform channels — кожен виклик асинхронний, є накладні витрати на серіалізацію даних. google_maps_flutter рендерить карту через PlatformView — це нативний UIView/View, вбудований у Flutter-дерево. До Impeller це викликало проблеми з продуктивністю (Hybrid Composition vs Virtual Display). З Impeller ситуація покращилась, але PlatformView все ще дорожчий за чистий Flutter-віджет.

React Native повільніший у сценаріях з важкою JS-логікою на main thread. Парсинг великого JSON, складні обчислення — це блокує JS thread і видно як фриз UI. Рішення: Hermes (JS-двигун, оптимізований для RN) + винесення обчислень у нативний модуль або react-native-workers. З Hermes час холодного старту знижується на 30–40% порівняно з JavaScriptCore, тобто Hermes у 1,3–1,4 раза швидше за старий двигун.

Екосистема та зрілість

Dart — бар’єр входу для команд з JS/TS-бекграундом. Освоїти базовий Dart за тиждень реально. Перебудувати мислення під Flutter-віджети та widget tree — займає більше. TypeScript у React Native — стандарт де-факто. Команда з React-досвідом починає продуктивно швидше.

Коли обирати Flutter?

Коли обирати React Native?

• Команда з React/TypeScript-експертизою.
• Потрібен нативний look and feel платформи.
• Активне використання нативних компонентів (Maps, Camera з нативними можливостями).
• Шарінг коду з React-вебом через монорепозиторій.

Чи варто обирати KMM для вашого проєкту?

KMM вирішує не UI-проблему, а проблему дублювання бізнес-логіки. Концепція: пишемо бізнес-логіку, роботу з мережею, кеш, валідацію один раз на Kotlin. iOS отримує .framework через Kotlin/Native, Android використовує бібліотеку безпосередньо. UI на кожній платформі — нативний.

// Спільний Kotlin код — працює на iOS та Android
class UserRepository(
    private val httpClient: HttpClient, // Ktor
    private val database: AppDatabase   // SQLDelight
) {
    suspend fun getUser(id: String): User {
        return database.userQueries.selectById(id).executeAsOneOrNull()
            ?: httpClient.get("$BASE_URL/users/$id").body<User>().also {
                database.userQueries.insert(it)
            }
    }
}

Ktor — HTTP-клієнт для KMM (працює на iOS через Darwin engine, на Android через OkHttp). SQLDelight генерує typesafe Kotlin API для SQLite, працює на обох платформах.

Реальні обмеження KMM

Coroutines на iOS: suspend-функції з shared коду викликаються через автоматично згенеровані обгортки. SKIE (Swift/Kotlin Interface Enhancer) від Touchlab значно покращує Swift-інтерфейс: async/await замість callback, AsyncStream для Flow. Без SKIE працювати з coroutines із Swift незручно.

Compose Multiplatform: JetBrains розвиває Compose для iOS — UI на Compose працює на iOS через Metal. Це стирає межу з Flutter: один Compose-код для обох платформ. Статус на сьогодні: Beta, у production є ранні adopters (Touchlab, JetBrains власні продукти), але стабільність нижче Flutter.

Складність iOS-інтеграції: XCFramework з KMM-модуля додається в Xcode-проєкт. SPM-інтеграція з’явилась і працює. Але iOS-розробники повинні розуміти Kotlin-API та правила роботи з пам’яттю через Kotlin/Native (ARC + Kotlin GC працюють разом, це не завжди очевидно).

Коли KMM виправданий

У компанії вже є зрілі iOS та Android команди, які дублюють бізнес-логіку. Переводити все на Flutter або React Native — занадто радикально. KMM дозволяє почати з малого: винести мережевий шар і моделі в shared, залишити UI нативним. Поступова міграція без переписування всього.

«Маєте нативний досвід — використовуйте React Native, хочете контролювати кожен піксель — Flutter» — один із принципів, який ми застосовуємо під час консультацій.

Помилки, яких варто уникати при виборі стеку

Вибір Flutter «тому що одна кодова база» для додатку, який сильно зав’язаний на нативні API (custom camera, BLE, background processing). Реалізовувати це через platform channels — додаткова складність, яка з’їдає виграш у швидкості розробки.

React Native без розуміння JS-thread. Важкі операції на JS thread дають видимі фризи. Це вирішувано, але потребує розуміння архітектури — інакше додаток працюватиме гірше нативного.

KMM без iOS-розробника в команді. Shared Kotlin-код потребує iOS-інженера, який інтегрує фреймворк у Xcode, пише SwiftUI поверх KMM API та дебажить Kotlin/Native-краші.

Процес і терміни

Кроссплатформний проєкт проходить ті ж етапи, що й нативний: аудит вимог → вибір стеку → дизайн → розробка → тестування на реальних пристроях обох платформ → публікація в App Store та Google Play → підтримка.

Тестування на реальних пристроях — не опціональний етап. Емулятор не відтворює проблеми з пам’яттю на бюджетних Android-телефонах і не показує різницю в поведінці жестів на iOS.

Економія бюджету порівняно з двома нативними командами сягає 40–50%. Для проєкту середньої складності це становить $40,000–$80,000 на етапі MVP. Вартість розраховується індивідуально після аналізу стеку та вимог.

Що входить у нашу роботу

• Технічний аудит та вибір стеку під ваш проєкт.
• Проєктування архітектури (чиста архітектура, MVVM, BLoC/Redux).
• Розробка UI за макетами дизайну на обидві платформи.
• Інтеграція нативних модулів (камера, геолокація, пуш-повідомлення).
• Налаштування CI/CD (GitHub Actions, Codemagic).
• Тестування на реальних пристроях (iOS/Android) — не менше 40 сценаріїв.
• Підготовка та публікація в App Store і Google Play з урахуванням гайдлайнів (App Store Review, Google Play Policy).
• Технічна підтримка 3 місяці після запуску.
• Передача вихідного коду, документації, доступів — все під ключ.

Ми маємо 5+ років досвіду в кроссплатформній розробці, реалізували понад 30 успішних проєктів. Гарантуємо дотримання строків та якість коду. Зв'яжіться з нами для аудиту вашого проєкту — підберемо оптимальний стек за один день. Отримайте консультацію з вибору стеку вже сьогодні, замовте розробку під ключ та отримайте готовий кроссплатформний додаток в обумовлені терміни.