Налаштування Dependency Injection (Injectable) у Flutter-додатку

У проєкті з 50+ сервісами та репозиторіями ручна реєстрація залежностей через GetIt перетворюється на хаос. injection_container.dart розростається до 500+ рядків, порядок реєстрації збивається, а при рефакторингу забувають оновлювати реєстрацію. Результат — StateError: No instance of type ApiService found у рантаймі. Ми стикалися з цим десятки разів і навчилися вирішувати проблему автоматично. На одному з проєктів ручна реєстрація забирала до 3 днів роботи на кожну нову фічу.

Налаштування injectable — кодогенератора поверх GetIt — скорочує ручний код на 70% та виключає помилки реєстрації. Ви просто пишете аннотації @injectable або @lazySingleton, запускаєте build_runner, і він генерує файл injection.config.dart. Все, DI чистий і декларативний. Це знижує трудозатрати на підтримку до 80%.

Як injectable спрощує управління залежностями?

Ручна реєстрація в GetIt не масштабується: при 50+ залежностях легко заплутатися в порядку, забути оновити при рефакторингу, а чужий injection_container часто перетворюється на "чорну скриньку". injectable усуває цю ручну працю — додав аннотацію до класу, запустив build_runner, файл оновився автоматично. Економія часу — до 2 годин на тиждень на підтримці DI. На практиці це означає, що розробник не відволікається на рутину і рідше допускає помилки.

Як налаштувати injectable у проєкті?

Базове налаштування займає 10–15 хвилин. Додайте залежності в pubspec.yaml:

dependencies:
  get_it: ^7.6.0
  injectable: ^2.3.0
dev_dependencies:
  injectable_generator: ^2.4.0
  build_runner: ^2.4.0

Створіть точку входу — файл із функцією ініціалізації:

import 'package:get_it/get_it.dart';
import 'package:injectable/injectable.dart';
import 'injection.config.dart';

final sl = GetIt.instance;

@InjectableInit()
Future<void> configureDependencies() => sl.init();

Аннотуйте сервіс, наприклад:

@lazySingleton
class ApiService {
  final Dio _dio;
  ApiService(this._dio);
}

Запустіть генерацію: dart run build_runner build --delete-conflicting-outputs. Для постійної генерації використовуйте build_runner watch — він автоматично оновлює код при кожній зміні аннотацій.

Як працювати з оточеннями?

injectable підтримує @Environment аннотації — вбудована підтримка dev, staging, production без ручних умов. Приклад:

@dev
@LazySingleton(as: ApiService)
class MockApiService implements ApiService { ... }

@prod
@LazySingleton(as: ApiService)
class RealApiService implements ApiService { ... }

// Ініціалізація з оточенням:
await configureDependencies(environment: Environment.prod);

У тестах передаєте Environment.dev — моки підключаються автоматично. Жодних if в injection_container.

Як обробляти async-залежності?

Для асинхронної ініціалізації використовуйте @factoryMethod:

@singleton
class DatabaseService {
  late final Database _db;

  @factoryMethod
  static Future<DatabaseService> create() async {
    final service = DatabaseService();
    service._db = await openDatabase('app.db');
    return service;
  }
}

injectable згенерує registerSingletonAsync, а configureDependencies() поверне Future. Не забудьте await перед runApp.

Чому виникає помилка 'No instance of type'?

Найчастіша причина — розробник додав новий клас з аннотацією, але забув запустити build_runner. Додаток компілюється зі старим injection.config.dart, новий клас залишається незареєстрованим. Рішення: додайте build_runner watch у процес розробки або налаштуйте CI-крок для перевірки актуальності згенерованого коду.

Порівняння: ручний GetIt vs Injectable

Типові помилки при DI та їх вирішення

Як ми налаштовуємо DI у вашому проєкті

Налаштування Dependency Injection — частина нашої стандартної архітектури Flutter-проєктів. Ми виконуємо її під ключ: встановлюємо та конфігуруємо залежності (get_it, injectable, build_runner), створюємо точку входу з підтримкою оточень, аннотуємо всі сервіси, репозиторії та фабрики, налаштовуємо async-залежності та фабричні методи, інтегруємо кодогенерацію в CI/CD (автоматичний запуск build_runner), мігруємо існуючий ручний injection_container на аннотації та документуємо архітектуру DI. Після налаштування команда отримує чітку структуру, яку легко масштабувати при додаванні нових фіч. Новий розробник розбирається в DI-шарі за 30 хвилин замість кількох годин.

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

Робота займає 1–3 дні залежно від розміру проєкту. На новому проєкті — швидше, на існуючому з ручним DI — довше через міграцію та тестування коректності порядку реєстрацій. Результат: чиста, масштабована архітектура DI. Оцінимо ваш проєкт безкоштовно — просто напишіть.

Офіційна документація Injectable: pub.dev/packages/injectable

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