Flutter原生iOS端不使用插件时如何处理平台线程？

当你在Flutter 3.13及以上版本的iOS平台中，直接在AppDelegate里初始化平台通道而非使用插件时，可能会遇到以下错误：

[ERROR:flutter/shell/common/shell.cc(1015)] The 'CameraController' channel sent a message from native to Flutter on a non-platform thread. Platform channel messages must be sent on the platform thread. Failure to do so may result in data loss or crashes, and must be fixed in the plugin or application code creating that channel.

官方文档的示例仅针对插件场景，但你可以通过以下方式在非插件场景下解决线程问题：

步骤1：初始化通道时指定任务队列 #

创建FlutterMethodChannel时，通过FlutterViewController的binaryMessenger生成后台任务队列，并传入通道初始化参数：

let flutterController = window?.rootViewController as! FlutterViewController
// 创建后台任务队列
let taskQueue = flutterController.binaryMessenger.makeBackgroundTaskQueue()
// 初始化通道并绑定任务队列
let cameraChannel = FlutterMethodChannel(
    name: "CameraController",
    binaryMessenger: flutterController.binaryMessenger,
    taskQueue: taskQueue
)

步骤2：通过任务队列执行通道调用 #

后续调用通道方法时，直接利用通道绑定的任务队列执行，确保线程安全：

private func setupCameraConst() {
    cameraChannel.taskQueue?.async { [weak self] in
        guard let self = self else { return }
        self.cameraChannel.invokeMethod("setAspectRatio", arguments: self.aspectRatio)
        self.cameraChannel.invokeMethod("setMinZoomLevel", arguments: self.minZoom)
        self.cameraChannel.invokeMethod("setMaxZoomLevel", arguments: self.maxZoom)
        self.cameraChannel.invokeMethod("setMinExposure", arguments: self.minExposure)
        self.cameraChannel.invokeMethod("setMaxExposure", arguments: self.maxExposure)
        self.cameraChannel.invokeMethod("setOnFrontCamera", arguments: self.cameraPosition == .front)
    }
}

原理说明 #

Flutter要求平台通道的消息必须在指定的平台线程（或绑定的任务队列）中传递，避免跨线程操作导致的数据丢失或崩溃。通过给FlutterMethodChannel绑定任务队列，所有通道相关的消息都会自动在该队列上调度处理，无需手动频繁切换线程。同时使用weak self可以避免循环引用导致的内存泄漏问题。

内容的提问来源于stack exchange，提问作者nicover