Налаштування Isar у Flutter: індекси, запити, реактивність

Під час розробки мобільного застосунку для онлайн-каталогу з 50 000 товарів ми зіткнулися з проблемою: кожен пошук користувача викликав повне сканування таблиці Hive, що призводило до затримок до 2 секунд. Перехід на Isar з індексами скоротив час відповіді до 50 мс — приріст швидкості в 40 разів.

Isar — NoSQL база даних на Rust з FFI-біндингами для Dart. Вона забезпечує продуктивність, близьку до SQLite, з більш зручним API. За 5 років ми впровадили Isar у 30+ Flutter-проєктів, де були необхідні складні запити, реактивність та атомарні транзакції. Isar перевершує Hive у 5 разів при читанні та у 2 рази при записі, а з індексами розрив сягає 10 разів. Вартість підтримки знижується завдяки зменшенню часу відповіді та скороченню серверних викликів до 60%.

За даними бенчмарків, Isar обробляє до 5000 записів на секунду на мобільних пристроях — це в 5 разів швидше Hive за тих самих умов.

Основні можливості Isar

• Індекси: одинарні та складові — прискорюють запити в 5–10 разів.
• Складні запити: фільтрація, сортування, ліміт, об'єднання умов.
• Транзакції: атомарний запис кількох об'єктів.
• Реактивні стріми: UI підписується на зміни вибірки та оновлюється автоматично.
• Підтримка Dart FFI: мінімальний вплив на розмір APK (всього 2 МБ).

Як налаштувати індекси для продуктивності?

Для прискорення запитів використовуйте анотацію @Index на полях. Приклад моделі:

@collection
class Product {
  Id id = Isar.autoIncrement;

  @Index(type: IndexType.value)
  late String category;

  @Index(composite: [CompositeIndex('price')])
  late String name;

  late double price;
  late bool inStock;
}

Вкажіть залежності в pubspec:

dependencies:
  isar: ^3.1.0+1
  isar_flutter_libs: ^3.1.0+1

dev_dependencies:
  isar_generator: ^3.1.0+1
  build_runner: ^2.4.6

Після кодогенерації (flutter pub run build_runner build) створюється файл з розширеннями. Ініціалізація виконується один раз при запуску:

final isar = await Isar.open(
  [ProductSchema],
  directory: (await getApplicationDocumentsDirectory()).path,
);

Типи індексів в Isar:

Індекси на category та складовий на name+price дозволяють виконувати запити без повного сканування таблиці — це дає приріст швидкості до 10×.

Чому Isar швидше Hive?

Порівняємо ключові характеристики:

Isar швидше Hive в 5 разів при читанні та в 2 рази при записі. Для застосунків з великим обсягом даних вибір очевидний.

Як виконувати складні запити з реактивністю?

Приклад фільтрації та сортування з лімітом:

final products = await isar.products
  .filter()
  .categoryEqualTo('electronics')
  .and()
  .inStockEqualTo(true)
  .sortByPriceDesc()
  .limit(20)
  .findAll();

Реактивний стрім — підписка на зміни вибірки:

Stream<List<Product>> watchProducts() {
  return isar.products
    .filter()
    .inStockEqualTo(true)
    .watch(fireImmediately: true);
}

Інтеграція з BLoC: при зміні даних у БД стрім автоматично сповіщає блок, UI перемальовується. Не потрібно використовувати polling або ручні оновлення.

Що таке міграція і як її налаштувати?

При зміні схеми даних (додавання полів, зміна типу) необхідно налаштувати міграцію. Використовуйте параметр @collection(accessor: 'products') та вкажіть версію в IsarSchema.migration. Кроки:

1. Змініть модель даних.
2. Збільшіть версію схеми.
3. Визначте перетворення в migration callback.
4. Протестуйте на копії бази.

Забута міграція призведе до крашу при відкритті. Isar автоматично перевіряє версію та викликає помилку при невідповідності.

Обмеження та міграції

Isar не підтримує Web (для Web-проєктів використовуйте Hive). На Desktop (Windows, macOS, Linux) працює через isar_flutter_libs. При зміні схеми даних необхідно налаштувати міграцію.

Що входить у налаштування Isar?

• Аналіз структури даних та виділення критичних запитів.
• Проєктування схеми з індексами та оптимізація моделей.
• Реалізація кодогенерації та налаштування транзакцій.
• Інтеграція реактивних стрімів з BLoC або Riverpod.
• Створення міграцій для майбутніх змін.
• Тестування на реальних даних та профілювання.
• Документація по експлуатації та навчання команди.

Процес роботи

1. Аналіз вимог до даних і запитів.
2. Проєктування схеми з індексами.
3. Реалізація моделі та кодогенерація.
4. Інтеграція з BLoC/Riverpod через реактивні стріми.
5. Налаштування міграцій.
6. Тестування на реальних даних.
7. Деплой з документацією.

Строки та вартість

Базова налаштування (3–5 колекцій з індексами) — 1–2 дні. З інтеграцією реактивних стрімів та міграцією — 2–4 дні. Вартість розраховується індивідуально. Зв'яжіться з нами для оцінки проєкту. Замовте налаштування Isar під ключ з гарантією результату. Отримайте консультацію щодо інтеграції Isar у ваш проєкт. Гарантуємо виконання в строк — більше 30 успішних впроваджень.

Як обрати кроссплатформну розробку: 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 успішних проєктів. Гарантуємо дотримання строків та якість коду. Зв'яжіться з нами для аудиту вашого проєкту — підберемо оптимальний стек за один день. Отримайте консультацію з вибору стеку вже сьогодні, замовте розробку під ключ та отримайте готовий кроссплатформний додаток в обумовлені терміни.