Method Channel — bu nima, ishlash xususiyatlari va Flutterda qo'llanilishi

Method Channel nima va nima uchun kerak

Method Channel — bu Flutter platforma qatlamining markaziy komponenti bo'lib, u orqali Dart izolyatlari iOS yoki Androiddagi host dasturi bilan xabar almashadi. Kanalning asosiy vazifasi ikki platforma o'rtasidagi ma'lumot uzatish protokollaridagi farqlarni yashirish va dasturchi uchun yagona API taqdim etishdir.

Flutter dasturi kameraga, Bluetoothga, sensorlarga yoki boshqa native APIga kirishni talab qilganda, Dartdan to'g'ridan-to'g'ri chaqiruv mumkin emas. Flutter C++ dvigatelida ishlaydi va UIKit yoki Android SDK freymvorklariga kirish imkoniga ega emas. Method Channel Dart dunyosi bilan native kod dunyosi o'rtasida ko'prik yaratib, bu muammoni hal qiladi.

Google I/O 2024 ma'lumotlariga ko'ra, ishlab chiqarishdagi Flutter dasturlarining 80% dan ortig'i platforma xizmatlari bilan integratsiya uchun kamida bitta Method Channeldan foydalanadi. Bu zamonaviy loyihalar arxitekturasida kanalning muhim rolini tasdiqlaydi.

Dasturchi uchun Method Channel oddiy asinxron funksiyani chaqirish kabi ko'rinadi. Sahnada xabarning serializatsiyasi, uni dvigatel buferi orqali uzatish va platformaning asosiy oqimida native kodni bajarish sodir bo'ladi.

Method Channel qanday ishlaydi

O'zaro aloqa Method Channel orqali Dart tomoni metod nomi va argumentlarini o'z ichiga olgan xabarni yuborishi bilan boshlanadi. Flutter Engine bu xabarni qabul qiladi, uni standart StandardMethodCodec formatiga o'tkazadi va BinaryMessenger orqali native tomonga uzatadi.

Native tomonda deserializatsiya qilingan chaqiruvni qabul qiluvchi va tegishli mantiqni bajaruvchi handler — MethodCallHandler mavjud. Natija muvaffaqiyatli natija yoki kod va xabar bilan xatoni o'z ichiga olgan Response shaklida Dartga qaytariladi.

Chaqiruv jarayoni bosqichma-bosqich

Method Channel orqali butun chaqiruv tsikli olti bosqichga bo'linadi. Dart izolyati ulanishni aniqlash uchun noyob nomga ega kanal namunasini yaratadi. invokeMethod chaqirilganda, Dart platforma kodi MethodCodec yordamida metod nomi va argumentlarini serializatsiya qiladi, bu ularni StandardMessageCodec orqali ikkilik buferga aylantiradi.

Flutter Engine bu buferni soket orqali native tomonga uzatadi. Native BinaryMessenger xabarni o'qiydi, kanalni nomi bo'yicha aniqlaydi va ro'yxatdan o'tgan handlerni chaqirib, unga tahlil qilingan ma'lumotlar bilan FlutterMethodCall obyektini uzatadi. Handler kerakli kodni bajaradi va natijani qaytaradi, u teskari serializatsiya yo'lidan o'tib, Dartga Future sifatida kiradi.

Method Channel arxitekturasi: asosiy komponentlar

Method Channel arxitekturasi bir-biriga bog'liq bir nechta ob'ektlardan iborat bo'lib, ularning har biri ma'lumot uzatishning o'z bosqichi uchun javobgardir. Dart API dasturchidan past darajadagi serializatsiya va marshrutlash tafsilotlarini yashiradigan MethodChannel klassini taqdim etadi.

BinaryMessenger

BinaryMessenger — Dart va host-platforma o'rtasida ikkilik xabarlarni yuborish va qabul qilish uchun Flutter Engine-ning past darajadagi interfeysi. Har bir MethodChannel kanal nomi bo'yicha marshrutlashni ta'minlaydigan ma'lum bir BinaryMessenger-ga bog'lanadi. Dart tomonida BinaryMessenger klassi, Androidda io.flutter.embedding.engine paketidan BinaryMessenger, iOSda esa FlutterBinaryMessenger protokoli ishlatiladi.

MethodCodec va MessageCodec

MethodCodec — metod chaqiruvlari va qaytariladigan qiymatlarni ikkilik formatga aylantiruvchi kodlovchi. Flutter ikkita o'rnatilgan implementatsiya bilan ta'minlanadi: StandardMethodCodec (standart) va JSONMethodCodec (JSON satrlari uchun). StandardMethodCodec barcha asosiy Dart turlarini qo'llab-quvvatlagan holda ma'lumotlarni serializatsiya qiluvchi StandardMessageCodec-dan foydalanadi.

Method Channelda ma'lumot turlari va serializatsiya

StandardMessageCodec Dart, Kotlin va Swift o'rtasida muvofiqlikni ta'minlash uchun cheklangan ma'lumot turlari to'plamini qo'llab-quvvatlaydi. To'plamga kiradi: null, bool, int, double, String, Uint8List, Int32List, Int64List, Float64List, List va satr kalitlari bilan Map.

Boshqa barcha turlar — DateTime, DTO ob'ektlari yoki maxsus klasslar — sanab o'tilgan formatlardan biriga aylantirilishi kerak. Eng keng tarqalgan yondashuv murakkab ob'ektlarni maydonlar bilan Mapga serializatsiya qilish va qabul qiluvchi tomonda tuzilmani maydon lug'atidan tiklashdir.

Kamera tasvirlari kabi katta ikkilik ma'lumotlarni uzatish uchun Flutter MethodChannel orqali har bir chaqiruvda buferni to'liq nusxalashdan qochish uchun Uint8List bilan BasicMessageChannel dan foydalanishni tavsiya qiladi.

Androidda Method Channel: Kotlinda sozlash

Android tomonida Method Channel sozlash FlutterPlugin ni implementatsiya qiluvchi klassda yoki to'g'ridan-to'g'ri MainActivityda amalga oshiriladi. Birinchi yondashuv tavsiya etiladi, chunki u plagin hayotiy siklining to'g'ri boshqarilishini va add-to-app stsenariylari bilan muvofiqlikni ta'minlaydi.

Dart tomonidagi kabi bir xil nomga ega kanal namunasi yaratilgandan so'ng, setMethodCallHandler orqali MethodCallHandler ni ro'yxatdan o'tkazish kerak. Handler ichida dasturchi kiruvchi metod nomini when orqali tekshiradi va natijani result.success yoki xatoni result.error orqali kod va xabar bilan qaytaradi.

package com.example.app

import io.flutter.embedding.android.FlutterActivity
import io.flutter.plugin.common.MethodChannel

class MainActivity : FlutterActivity() {
    private val CHANNEL = "samples.flutter.dev/battery"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        val channel = MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL)
        channel.setMethodCallHandler { call, result ->
            when (call.method) {
                "getBatteryLevel" -> {
                    val batteryLevel = getBatteryLevel()
                    if (batteryLevel != null) {
                        result.success(batteryLevel)
                    } else {
                        result.error("UNAVAILABLE", "Battery not available", null)
                    }
                }
                else -> result.notImplemented()
            }
        }
    }
}

Ushbu misolda samples.flutter.dev/battery nomli kanal getBatteryLevel chaqiruvini qayta ishlaydi, Android BatteryManager orqali batareya darajasini oladi va uni Dart kodiga qaytaradi. Kanal nomi ikkala tomonda bir xil bo'lishi kerak, aks holda xabar handlerga etib bormaydi.

FlutterPlugin orqali plagin yaratish

Ishlab chiqarish kodi uchun Method Channel mantiqini FlutterPlugin ni implementatsiya qiluvchi alohida klassga ajratish tavsiya etiladi. Bu plagin loyihalar o'rtasida qayta ishlatilishiga imkon beradi va onDetachedFromEngine chaqirilganda resurslarning to'g'ri tozalanishini kafolatlaydi. Plagin registerWith orqali ro'yxatdan o'tkaziladi va Activitydan alohida sinovdan o'tkazilishi mumkin.

iOSda Method Channel: Swiftda sozlash

iOSda Method Channel FlutterPlugin protokolini implementatsiya qiluvchi klassda yoki AppDelegate-da sozlanadi. Tavsiya etilgan usul FlutterPluginRegistrar orqali ro'yxatdan o'tadigan va Flutter Engine tomonidan boshqariladigan alohida plagin klassini yaratishdir.

Dart tomoni chaqiruv yuboradi, native handler metod nomi va argumentlari bilan FlutterMethodCall ob'ektini oladi. Dasturchi chaqirilgan metodni call.method bo'yicha switch orqali aniqlaydi va natijani result yopilishi orqali qaytaradi. iOS APIga kirish uchun UIKit va boshqa tizim freymvorklari ishlatiladi.

import Flutter
import UIKit

public class BatteryPlugin: NSObject, FlutterPlugin {
    public static func register(with registrar: FlutterPluginRegistrar) {
        let channel = FlutterMethodChannel(
            name: "samples.flutter.dev/battery",
            binaryMessenger: registrar.messenger())
        let instance = BatteryPlugin()
        registrar.addMethodCallDelegate(instance, channel: channel)
    }

    public func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
        switch call.method {
        case "getBatteryLevel":
            let device = UIDevice.current
            device.isBatteryMonitoringEnabled = true
            let level = Int(device.batteryLevel * 100)
            result(level)
        default:
            result(FlutterMethodNotImplemented)
        }
    }
}

FlutterPlugin yondashuvi Flutter Engine yo'q qilinganda plaginning to'g'ri ro'yxatdan o'tkazilishi va o'chirilishini kafolatlaydi. Swift handlerida call.method bo'yicha switch ishlatiladi, har bir case natijani result yopilishi orqali qaytaradi. Argumentlar call.arguments orqali tegishli turga o'tkazish bilan mavjud.

Method Channel eng yaxshi amaliyotlari va keng tarqalgan xatolar

Method Channel bilan ishlashda dasturning ishlashi va barqarorligini ta'minlash uchun bir nechta asosiy qoidalarga rioya qilish muhimdir. Asosiy tavsiya uzatiladigan ma'lumotlar soni va hajmini minimallashtirish, ayniqsa animatsiya siklidagi yoki yuqori chastotali chaqiruvlardadir.

Xatolarni qayta ishlash

Native tomonda har doim istisnolarni qayta ishlash va inson o'qiy oladigan xabar bilan result.error orqali xatoni qaytarish kerak. Dart tomonida har bir invokeMethod chaqiruvi PlatformException ni ushlash uchun try-catch bilan o'ralgan bo'lishi kerak. Xatolarni e'tiborsiz qoldirish dasturning tushunarli sababsiz kutilmaganda qulashiga olib kelishi mumkin.

Oqimlarni izolyatsiya qilish

Odatiy bo'lib, Method Channel native kodni platformaning asosiy oqimida bajaradi. Agar handler og'ir operatsiyani bajarsa, bajarishni Androidda Kotlin Coroutines yoki iOSda Grand Central Dispatch yordamida fon oqimiga o'tkazish kerak. Natijani result orqali faqat asosiy oqimda ish tugagandan so'ng qaytarish kerak.

Kanallarni nomlash

Kanallar uchun teskari domen notasidan foydalanib noyob nomlarni tanlang — masalan, com.example.app/feature. Qisqa nomlar boshqa plaginlar bilan ziddiyatga kirishishi mumkin. Flutter kanallarni global ro'yxatdan o'tkazadi, shuning uchun turli plaginlardagi bir xil nomlar handlerning qayta yozilishiga va chaqiruvlarning ishlamasligiga olib keladi.