Platform Channel: nó là gì, các loại và cách hoạt động trong phát triển di động

Platform Channel trong Flutter là gì?

Platform Channel là công nghệ Flutter cung cấp giao tiếp hai chiều giữa mã Dart của ứng dụng và mã gốc của hệ điều hành Android và iOS. Nếu không có Platform Channel, ứng dụng Flutter bị giới hạn ở các khả năng do framework cung cấp và không thể truy cập trực tiếp vào API máy ảnh, cảm biến, Bluetooth, hệ thống tệp và các chức năng cấp thấp khác của thiết bị.

Kiến trúc Platform Channel được xây dựng trên nguyên tắc trao đổi thông điệp bất đồng bộ. Phía Dart gửi yêu cầu qua kênh, phía gốc xử lý yêu cầu đó và trả về kết quả. Tất cả thông điệp được tuần tự hóa thành định dạng nhị phân và truyền qua bộ đệm thông điệp của Flutter Engine, đảm bảo độ trễ tối thiểu khi truyền dữ liệu giữa các môi trường thực thi.

Mỗi Platform Channel được xác định bằng một tên logic duy nhất — một chuỗi đóng vai trò là địa chỉ để định tuyến thông điệp. Phía Dart và phía gốc phải sử dụng cùng tên kênh để giao tiếp được thiết lập chính xác. Flutter hỗ trợ số lượng kênh tùy ý trong một ứng dụng và mỗi kênh hoạt động độc lập với các kênh khác.

Theo tài liệu chính thức của Flutter, Platform Channel xử lý thông điệp theo cùng thứ tự chúng được gửi, đảm bảo trình tự gọi có thể dự đoán. Điều này rất quan trọng đối với các tình huống mà thứ tự xử lý ảnh hưởng đến tính đúng đắn, như khởi tạo tuần tự các mô-đun gốc hoặc chuỗi các hoạt động phụ thuộc.

Cách Platform Channel hoạt động: kiến trúc truyền thông điệp

Cơ chế truyền thông điệp qua Platform Channel bao gồm ba lớp chính: phía Dart gửi thông điệp dưới dạng Map hoặc List qua invokeMethod, Flutter Engine tuần tự hóa nó bằng StandardMethodCodec và phía gốc nhận cuộc gọi trong trình xử lý của nó. Kết quả được trả về theo cùng đường dẫn theo hướng ngược lại.

Quá trình tuần tự hóa tự động chuyển đổi kiểu dữ liệu Dart sang các kiểu tương đương trên nền tảng gốc. Số, chuỗi, giá trị boolean, danh sách và từ điển được hỗ trợ mà không cần cấu hình thêm từ nhà phát triển. Các kiểu dữ liệu tùy chỉnh phải được tuần tự hóa thủ công, ví dụ thành chuỗi JSON, trước khi gửi qua kênh.

Về phía Flutter Engine, thông điệp đi vào hàng đợi luồng chính của nền tảng gốc. Trên Android, đây là luồng chính của ứng dụng, trên iOS là vòng lặp chính. Điều này có nghĩa là các hoạt động kéo dài trong trình xử lý kênh sẽ chặn giao diện người dùng và gây treo. Các nhà phát triển được khuyên nên thực hiện các tác vụ nặng trong luồng nền và trả về kết quả bất đồng bộ qua callback.

Hiệu suất của Platform Channel đủ cao cho hầu hết các trường hợp sử dụng: thời gian truyền một thông điệp dưới 1 mili giây trên các thiết bị hiện đại. Tuy nhiên, đối với các hoạt động tải cao như xử lý luồng video thời gian thực, nên sử dụng Dart FFI hoặc plugin gốc có quyền truy cập trực tiếp vào bộ nhớ thiết bị.

Một hạn chế chính của kiến trúc: Platform Channel không hỗ trợ truyền bộ mô tả tệp, con trỏ bộ nhớ hoặc đối tượng gốc. Tất cả dữ liệu phải có thể tuần tự hóa thành định dạng nhị phân. Để truyền khối lượng dữ liệu lớn trong phạm vi megabyte, hãy sử dụng tệp tạm thời với đường dẫn được truyền qua kênh.

Ba loại Platform Channel trong phát triển Flutter

Flutter cung cấp ba loại Platform Channel, mỗi loại được thiết kế cho một tình huống tương tác cụ thể. Việc chọn đúng loại kênh sẽ quyết định kiến trúc tích hợp và khả năng bảo trì mã ở cả hai phía — Dart và gốc — vì vậy điều quan trọng là phải hiểu sự khác biệt giữa MethodChannel, EventChannel và BasicMessageChannel.

MethodChannel — gọi phương thức ở phía gốc

MethodChannel là loại Platform Channel phổ biến nhất, triển khai mẫu gọi thủ tục từ xa. Dart gửi tên phương thức và đối số, phía gốc thực hiện hoạt động và trả về kết quả. Mỗi cuộc gọi trả về một Future, cho phép sử dụng cấu trúc async và await trong mã Dart để thực hiện các hoạt động bất đồng bộ thuận tiện.

Loại kênh này phù hợp cho các hoạt động yêu cầu-phản hồi: lấy mức pin, đọc dữ liệu cảm biến, thực hiện tính toán ở phía gốc hoặc yêu cầu dữ liệu từ dịch vụ hệ thống. MethodChannel hỗ trợ các kiểu dữ liệu tiêu chuẩn qua StandardMethodCodec, bao gồm các giá trị null nhờ hỗ trợ Null safety trong Dart hiện đại.

Trong các dự án thực tế, MethodChannel được sử dụng trong hầu hết các plugin chính thức của Flutter. Ví dụ, các gói camera, battery và path_provider hoạt động thông qua loại kênh này, cung cấp quyền truy cập vào API gốc mà không cần viết mã tích hợp tùy chỉnh cho mỗi nền tảng.

EventChannel — đăng ký luồng sự kiện

EventChannel được thiết kế cho các tình huống mà phía gốc tạo ra một luồng sự kiện liên tục theo thời gian. Dữ liệu được truyền sang Dart qua Stream, cho phép đăng ký nhận cập nhật theo thời gian thực. Các trường hợp sử dụng điển hình bao gồm đọc gia tốc kế, tọa độ GPS, thay đổi trạng thái Bluetooth và thông báo từ dịch vụ hệ thống.

Không giống như MethodChannel, EventChannel sử dụng mô hình xuất bản-đăng ký. Phía gốc gửi sự kiện khi chúng xảy ra, không cần yêu cầu rõ ràng từ mã Dart. Người đăng ký ở phía Dart nhận từng sự kiện trong một phần tử luồng riêng biệt và có thể lọc hoặc biến đổi dữ liệu nhận được trước khi sử dụng trong giao diện.

Khi sử dụng EventChannel, cần quản lý đúng cách các đăng ký và hủy bỏ chúng. Mỗi lệnh gọi StreamSubscription phải được hủy khi hoàn thành công việc với kênh để tránh rò rỉ bộ nhớ ở phía gốc. Nền tảng Flutter tự động hủy luồng khi một widget bị phá hủy, nhưng quản lý đăng ký rõ ràng cải thiện độ tin cậy của ứng dụng trong các tình huống chạy dài.

BasicMessageChannel — trao đổi thông điệp tự do

BasicMessageChannel là loại Platform Channel linh hoạt nhất, được thiết kế để trao đổi thông điệp bất đồng bộ tùy ý. Không giống như MethodChannel, nơi mỗi thông điệp chứa tên phương thức và đối số, BasicMessageChannel chỉ truyền tải trọng mà không có định tuyến tích hợp. Người gửi gửi thông điệp, người nhận xử lý và trả về phản hồi.

Loại kênh này thuận tiện cho các giao thức tương tác tùy chỉnh, nơi cấu trúc thông điệp có thể thay đổi linh hoạt tùy theo trạng thái ứng dụng. BasicMessageChannel sử dụng StandardMessageCodec theo mặc định nhưng hỗ trợ cắm MessageCodec tùy ý cho các định dạng tuần tự hóa dữ liệu không chuẩn.

Trong thực tế, BasicMessageChannel được sử dụng ít hơn MethodChannel vì nó yêu cầu xử lý định tuyến thông điệp thủ công mà không có mẫu đặt tên tích hợp. Tuy nhiên, nó không thể thiếu khi tích hợp với các thư viện gốc mong đợi một định dạng thông điệp cụ thể khác với mẫu yêu cầu-phản hồi tiêu chuẩn được triển khai trong MethodChannel.

Triển khai Platform Channel: ví dụ mã trên Dart và nền tảng gốc

Hãy xem xét một triển khai Platform Channel thực tế bằng ví dụ lấy mức pin của thiết bị. Ví dụ này minh họa quy trình làm việc đầy đủ: khai báo MethodChannel ở phía Dart, triển khai trình xử lý trên Android và iOS, và xử lý lỗi chính xác khi dữ liệu không khả dụng hoặc thiếu quyền cần thiết.

MethodChannel ở phía Dart

Ở phía Dart, một phiên bản của MethodChannel được tạo với tên kênh chuỗi duy nhất. Phương thức invokeMethod gửi yêu cầu đến phía gốc và chờ kết quả dưới dạng Future. Xử lý lỗi được thực hiện bằng cách bắt PlatformException, mà phía gốc trả về khi có ngoại lệ xảy ra trong quá trình xử lý yêu cầu.

import 'package:flutter/services.dart';

class BatteryPlugin {
  static const _channel = MethodChannel(
    'samples.flutter.dev/battery',
  );

  Future<String> getBatteryLevel() async {
    try {
      final result = await _channel.invokeMethod<int>(
        'getBatteryLevel',
      );
      return 'Battery level: $result%';
    } on PlatformException catch (e) {
      return 'Failed: ${e.message}';
    }
  }
}

Xử lý trên Android bằng Kotlin

Ở phía Android, trình xử lý được đăng ký trong MainActivity thông qua phương thức configureFlutterEngine. Bên trong setMethodCallHandler, tên phương thức đến được kiểm tra, một cuộc gọi gốc đến BatteryManager được thực hiện để lấy mức pin và kết quả được trả về thông qua đối tượng result. Đối với các phương thức không được kênh hỗ trợ, result.notImplemented được gọi.

import android.os.BatteryManager
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)
    MethodChannel(
      flutterEngine.dartExecutor.binaryMessenger,
      CHANNEL
    ).setMethodCallHandler { call, result ->
      if (call.method == "getBatteryLevel") {
        val level = getBatteryLevel()
        if (level != -1) {
          result.success(level)
        } else {
          result.error(
            "UNAVAILABLE",
            "Battery level not available",
            null
          )
        }
      } else {
        result.notImplemented()
      }
    }
  }

  private fun getBatteryLevel(): Int {
    val manager = getSystemService(BATTERY_SERVICE) as BatteryManager
    return manager.getIntProperty(
      BatteryManager.BATTERY_PROPERTY_CAPACITY
    )
  }
}

Xử lý trên iOS bằng Swift

Trên nền tảng iOS, trình xử lý được đăng ký trong lớp AppDelegate thông qua FlutterMethodChannel. Mã Swift nhận cuộc gọi đến, truy cập API hệ thống UIDevice để lấy mức pin và trả về kết quả cho Flutter. Xử lý bất đồng bộ với capture weak self cho phép thực hiện các yêu cầu mà không có nguy cơ chu kỳ tham chiếu mạnh trong bộ nhớ.

import UIKit
import Flutter

@UIApplicationMain
class AppDelegate: FlutterAppDelegate {
  override func application(
    application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    let controller = window?.rootViewController as! FlutterViewController
    let channel = FlutterMethodChannel(
      name: "samples.flutter.dev/battery",
      binaryMessenger: controller.binaryMessenger
    )
    channel.setMethodCallHandler { [weak self] call, result in
      if call.method == "getBatteryLevel" {
        let level = self?.getBatteryLevel() ?? -1
        if level >= 0 {
          result(level)
        } else {
          result(FlutterError(
            code: "UNAVAILABLE",
            message: "Battery level not available",
            details: nil
          ))
        }
      } else {
        result(FlutterMethodNotImplemented)
      }
    }
    return super.application(
      application: application,
      didFinishLaunchingWithOptions: launchOptions
    )
  }

  private func getBatteryLevel() -> Int {
    let device = UIDevice.current
    device.isBatteryMonitoringEnabled = true
    return Int(device.batteryLevel * 100)
  }
}

Khi nào cần Platform Channel trong các dự án Flutter

Platform Channel là cần thiết bất cứ khi nào ứng dụng Flutter yêu cầu truy cập vào các khả năng của thiết bị chưa được triển khai trong các gói tiêu chuẩn. Nhà phát triển nên tạo kênh tùy chỉnh khi tích hợp với SDK gốc cho máy ảnh, sinh trắc học, NFC, Bluetooth Low Energy hoặc khi làm việc với hệ thống tệp bên ngoài hộp cát của ứng dụng.

Kịch bản điển hình đầu tiên là sử dụng API gốc mà không thể truy cập trực tiếp từ Dart. Điều này bao gồm các dịch vụ hệ thống Android và iOS, cảm biến phần cứng với giao thức truyền dữ liệu không chuẩn, thông báo đẩy với logic xử lý tùy chỉnh và các hoạt động mã hóa yêu cầu Mô-đun Bảo mật Phần cứng để lưu trữ khóa an toàn.

Kịch bản thứ hai là tích hợp mã gốc hiện có vào dự án Flutter. Nếu một công ty đã phát triển thư viện gốc cho Android hoặc iOS, Platform Channel cho phép sử dụng lại nó mà không cần chuyển sang Dart. Điều này tăng tốc quá trình di chuyển ứng dụng kết hợp sang Flutter và bảo toàn đầu tư vào mã gốc hiện có và logic kinh doanh tích lũy.

Kịch bản thứ ba là xuất bản plugin Flutter tùy chỉnh trên pub.dev. Tất cả các plugin phổ biến đều sử dụng Platform Channel để cung cấp API Dart thống nhất mà bên trong gọi mã gốc của mỗi nền tảng. Đây là cách tiếp cận tiêu chuẩn được nhóm Flutter khuyến nghị để tạo các gói có thể tái sử dụng hỗ trợ cả hai nền tảng di động.

Khi lựa chọn giữa việc tạo Platform Channel tùy chỉnh và sử dụng gói có sẵn từ pub.dev, trước tiên nên kiểm tra tính khả dụng của giải pháp hiện có. Các gói camera, geolocator, shared_preferences và path_provider bao phủ hầu hết các nhu cầu điển hình. Platform Channel tùy chỉnh chỉ hợp lý khi không có gói phù hợp hoặc khi cần tùy chỉnh sâu hành vi gốc mà giải pháp hiện tại không cung cấp.