Flutter-плагин с нативной функциональностью: iOS и Android

Создание Flutter-плагина для нативной функциональности

Вы интегрируете проприетарный SDK партнёра — C++ библиотеку с нативными вызовами. Готовых плагинов на pub.dev нет, а обёртка через ffi не подходит из-за сложного lifecycle — например, необходимо правильно управлять памятью и синхронизацией с Dart-изолятом. Знакомая ситуация? Тогда пишем собственный плагин через Platform Channels. Мы, команда мобильных разработчиков с 5+ летним стажем, берём такие задачи под ключ: от проектирования API до публикации на pub.dev и интеграции в ваш проект. У нас за плечами реализация более 30 кастомных плагинов для заказчиков из финтеха, медицины и IoT. Снижаем бюджет на интеграцию до 40% за счёт использования Pigeon и оптимизации платформенных каналов.

Как выбрать тип Platform Channel?

Определение правильного канала — основа стабильной работы плагина. Сравним три варианта:

Типичный пример: плагин для работы с BLE-устройством. Сканирование устройств — EventChannel (непрерывный поток найденных устройств). Подключение/отключение — MethodChannel. Получение уведомлений от характеристики — снова EventChannel.

Почему Pigeon лучше ручной сериализации?

StandardMessageCodec (дефолтный) поддерживает примитивы, List, Map. Для кастомных объектов — сериализуем в Map<String, dynamic> на Dart-стороне и получаем HashMap на Kotlin / [String: Any] на Swift. Но это чревато опечатками в именах ключей. Альтернатива — Pigeon: инструмент от Flutter team для генерации type-safe API по .dart-спецификации. Pigeon генерирует Kotlin/Swift код с типизированными классами — исключает runtime-ошибки от опечаток в именах методов. Применение Pigeon сокращает время разработки на 30–40% и упрощает поддержку. Согласно официальной документации Flutter, использование Pigeon рекомендовано для плагинов со сложной сериализацией. Подробнее см. Platform Channels.

Сравните две стратегии:

Как мы разрабатываем плагин: этапы

1. Анализ требований: какие нативные функции нужны, какие разрешения, lifecycle. Оцениваем объём: 1–2 метода под одну платформу или 10+ с EventChannel для обеих.
2. Проектирование Dart API: контракт через Pigeon или ручные MethodChannel/EventChannel. Определяем типы данных.
3. Реализация на iOS (Swift) и Android (Kotlin): используем FlutterPlugin, ActivityAware, MethodCallHandler. Обработка всех edge cases и ошибок.
4. Тестирование: модульные тесты на Dart, интеграционные тесты на обеих платформах, тестирование на реальных устройствах.
5. Интеграция в ваш проект: подключаем через git dependency или публикуем на pub.dev.
6. Документация: README с API, примерами, CHANGELOG.

Структура плагина

Создаём через flutter create --template=plugin my_plugin. Структура:

my_plugin/
  lib/my_plugin.dart          — Dart API
  android/src/.../MyPlugin.kt — Android реализация
  ios/Classes/MyPlugin.swift  — iOS реализация
  example/                    — пример приложения для тестирования

Dart-сторона объявляет контракт:

class MyPlugin {
  static const MethodChannel _channel = MethodChannel('my_plugin');

  static Future<String?> getPlatformVersion() async {
    return await _channel.invokeMethod<String>('getPlatformVersion');
  }

  static Stream<ScanResult> get scanResults {
    return const EventChannel('my_plugin/scan_results')
        .receiveBroadcastStream()
        .map((data) => ScanResult.fromMap(Map<String, dynamic>.from(data)));
  }
}

Android-реализация: FlutterPlugin + ActivityAware

На Android плагин реализует FlutterPlugin для lifecycle, MethodCallHandler для обработки вызовов. Если нужен Activity (например для permission request), дополнительно ActivityAware:

class MyPlugin : FlutterPlugin, MethodCallHandler, ActivityAware {
    private lateinit var channel: MethodChannel
    private var activity: Activity? = null

    override fun onAttachedToEngine(binding: FlutterPlugin.FlutterPluginBinding) {
        channel = MethodChannel(binding.binaryMessenger, "my_plugin")
        channel.setMethodCallHandler(this)
    }

    override fun onMethodCall(call: MethodCall, result: Result) {
        when (call.method) {
            "getPlatformVersion" -> result.success("Android ${android.os.Build.VERSION.RELEASE}")
            else -> result.notImplemented()
        }
    }

    override fun onAttachedToActivity(binding: ActivityPluginBinding) {
        activity = binding.activity
    }
}

Критичная деталь: result.success(), result.error() и result.notImplemented() должны вызываться ровно один раз. Вызов result.success() дважды — краш IllegalStateException: Reply already submitted. Мы гарантируем отсутствие таких ошибок в нашем коде.

iOS-реализация на Swift

public class MyPlugin: NSObject, FlutterPlugin {
    public static func register(with registrar: FlutterPluginRegistrar) {
        let channel = FlutterMethodChannel(
            name: "my_plugin",
            binaryMessenger: registrar.messenger()
        )
        let instance = MyPlugin()
        registrar.addMethodCallDelegate(instance, channel: channel)
    }

    public func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
        switch call.method {
        case "getPlatformVersion":
            result("iOS " + UIDevice.current.systemVersion)
        default:
            result(FlutterMethodNotImplemented)
        }
    }
}

EventChannel и memory leaks

При использовании EventChannel на Android нативный сайд получает EventSink. Типичная утечка: держим EventSink в поле класса, Activity пересоздаётся при повороте экрана, старый EventSink не валидируется — и вызов sink.success() после уничтожения бросает исключение. Решение: обнулять sink в onCancel() и проверять перед каждым вызовом.

Публикация и версионирование

Для внутреннего использования плагин живёт в git-репозитории и подключается через path или git dependency в pubspec.yaml. Для публикации на pub.dev — flutter pub publish с обязательным pubspec.yaml с homepage, repository, полным CHANGELOG.md.

Что входит в работу

• Разработка Dart API и нативной реализации для iOS и Android
• Интеграция с вашим проектом (пример использования)
• Документация по API и сборке
• Публикация на pub.dev или предоставление доступа к git-репозиторию
• Гарантия стабильности платформенных каналов и обработка ошибок

Разработка плагина: простой (1–2 метода, одна платформа) — 2–4 дня. Полноценный cross-platform плагин с EventChannel, permissions и edge-case handling — 2–4 недели. Стоимость рассчитывается индивидуально. Получите консультацию: свяжитесь с нами для оценки вашего проекта. Мы уже реализовали более 30 кастомных плагинов для заказчиков из финтеха, медицины и IoT — присоединяйтесь. Закажите разработку плагина прямо сейчас.

Как выбрать кроссплатформенную разработку: Flutter, React Native или KMM?

Мы часто работаем со стартапами, которым нужно два приложения — iOS и Android — с бюджетом на одну команду. Или корпорациями, которые хотят выпустить внутренний инструмент за три месяца на обе платформы. Кроссплатформенная разработка решает конкретную экономическую задачу: один кодовый базис вместо двух. Вопрос не «кроссплатформа или нативная» — вопрос «какой инструмент под какую задачу».

Каждый фреймворк диктует свой стек и накладывает ограничения. Неправильный выбор приводит к переписыванию проекта через полгода — мы это видели не раз. Поэтому перед стартом проводим аудит технологических требований и экспертизы команды.

Три главных игрока сейчас: Flutter, React Native и Kotlin Multiplatform Mobile. Они решают разные проблемы и плохо сравниваются в лоб. Ниже разберём, как выбрать оптимальный вариант под ваш проект.

Как мы выбираем технологию: 4 шага

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.

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

Dart — барьер входа для команд с JS/TS-бэкграундом. Освоить базовый Dart за неделю реально. Перестроить мышление под Flutter-виджеты и widget tree — занимает больше.

TypeScript в React Native — стандарт де-факто. Команда с React-опытом начинает продуктивно быстрее.

Когда выбирать Flutter?

• Нужен единый брендовый UI на всех платформах (iOS, Android, Web, Desktop).
• Команда готова к Dart.
• Много кастомной анимации и кастомного UI — Flutter более предсказуем.
• Приложение не завязано на специфические нативные API.

Когда выбирать React Native?

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

Kotlin Multiplatform Mobile: другая история

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

// Shared 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 нативным. Постепенная миграция без переписывания всего.

Типичные ошибки при выборе технологии

Выбор Flutter «потому что один кодовый базис» для приложения, которое сильно завязано на нативные API (custom camera, BLE, background processing). Реализовывать это через platform channels — дополнительная сложность, которая съедает выигрыш по скорости разработки.

React Native без понимания JS-thread. Тяжёлые операции на JS thread дают видимые фризы. Это решаемо, но требует понимания architecture — иначе приложение будет работать хуже нативного.

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

Процесс и сроки

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

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

Экономия бюджета по сравнению с двумя нативными командами достигает 40–50%. Стоимость рассчитывается индивидуально после анализа стека и требований.

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

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

Оценим ваш проект за один день — свяжитесь с нами для консультации по выбору стека. Закажите разработку под ключ и получите готовое кроссплатформенное приложение в оговорённые сроки.

Источники:

• Flutter documentation
• React Native documentation
• Flutter на Wikipedia
• React Native на Wikipedia