参考

一、Flutter 中 Channel 基本概念

1. Flutter 中 Channel 的概念

  • Channel 也就是通道的意思,主要是用于和 原生Native之间进行交互 ,双方相互传递数据。
  • Channel 在Native的端就是一个类。

2. Flutter 中 Channel 有哪些

三种Channel之间互相独立,各有用途,但它们在设计上却非常相近。

frc 9ca1bb1641ff69120cf559013db271aa - Flutter 开发 (3)Flutter 与 Native 的交互
790890-0bfb255357871f19.png
  • BasicMessageChannel:用于传递字符串和半结构化的信息。

  • MethodChannel:用于传递方法调用(method invocation)。

  • EventChannel: 用于数据流(event streams)的通信(例如 NSData)。

每种Channel均有三个重要成员变量:

+ (instancetype)methodChannelWithName:(NSString*)name
                      binaryMessenger:(NSObject*)messenger
                                codec:(NSObject*)codec

使用示例:

  FlutterMethodChannel* batteryChannel = [FlutterMethodChannel
      methodChannelWithName:@"samples.flutter.io/battery"
            binaryMessenger:controller];
  __weak typeof(self) weakSelf = self;
  [batteryChannel setMethodCallHandler:^(FlutterMethodCall* call,
                                         FlutterResult result) {
    if ([@"getBatteryLevel" isEqualToString:call.method]) {
      int batteryLevel = [weakSelf getBatteryLevel];
      if (batteryLevel == -1) {
        result([FlutterError errorWithCode:@"UNAVAILABLE"
                                   message:@"Battery info unavailable"
                                   details:nil]);
      } else {
        result(@(batteryLevel));
      }
    } else {
      result(FlutterMethodNotImplemented);
    }
  }];
  • name:String类型,代表Channel的名字,也是其唯一标识符,Flutter与Native保持一致用于识别通信
  • messager:BinaryMessenger协议类型,代表消息信使,是消息的发送与接收的工具,信使实现了协议方法。例如:
- (void)setMessageHandlerOnChannel:(NSString*)channel
              binaryMessageHandler:(FlutterBinaryMessageHandler _Nullable)handler

上图controller实现了setMessageHandlerOnChannel方法

  • codec: MessageCodec 类型 或MethodCodec类型,代表消息的编解码器。

2. Channel 的成员变量 – name

一个Flutter应用中可能存在多个Channel,每个Channel在创建时必须指定一个独一无二的name,Channel之间使用 name 来区分彼此。
当有消息从 Flutter端 发送到 Native端 时,会根据其传递过来的 channel name 找到该Channel对应的Handler(消息处理器)。

(1)Channel 的成员变量 – BinaryMessenger

  • BinaryMessenger是Platform端与Flutter端通信的工具,传递数据格式为二进制。

    frc d4977b4541f2e2b2ecf1b02f27279c97 - Flutter 开发 (3)Flutter 与 Native 的交互
    790890-0bfb255357871f19.png
  • 当我们初始化一个Channel,并向该Channel注册处理消息的Handler时,实际上会生成一个与之对应的 BinaryMessageHandler ,并以 channel name 为 key,注册到BinaryMessenger 中。
  • 当Flutter端发送消息到BinaryMessenger时,BinaryMessenger会根据其入参channel找到对应的BinaryMessageHandler,并交由其处理。

Binarymessenger 在 iOS 和 Android 上分别是什么?

  • Binarymessenger 在Android端是一个接口,其具体实现为FlutterNativeView。
    在iOS端是一个协议,名称为FlutterBinaryMessenger,FlutterViewController 遵循了它。

(3) Channel 的成员变量 – codec (消息编解码器)

Codec主要用于将二进制格式的数据转化为Handler能够识别的数据

如何解决数据传递编解码问题?

  • 由于Channel从BinaryMessageHandler接收到的消息是 二进制格式数据 ,无法直接使用,故Channel会将该二进制消息通过Codec(消息编解码器)解码为能识别的消息并传递给Handler进行处理。
  • 当Handler处理完消息之后,会通过回调函数返回result,并将result通过编解码器编码为二进制格式数据,通过BinaryMessenger发送回Flutter端。
frc 0a13857cc6c84a0007570c459be1e5e7 - Flutter 开发 (3)Flutter 与 Native 的交互
790890-7123f97834a141c9.png

从该图可看出:
- 三个channel
- 两种消息Codec:信息编解码和方法编解码
- 每种支持的:标准二进制解码,JSON解码 字符串解码

MessageCodec 有多种不同实现

  • BinaryCodec

BinaryCodec 在编解码过程中什么都没做,只是原封不动将二进制数据消息返回而已。
其返回值类型和入参的类型相同,均为二进制格式(Android中为ByteBuffer,iOS中为NSData)

  • StringCodec

StringCodec 用于字符串与二进制数据之间的编解码,其编码格式为UTF-8。

  • JSONMessageCodec

JSONMessageCodec用于基础数据与二进制数据之间的编解码,其支持基础数据类型以及列表、字典。其在iOS端使用了NSJSONSerialization作为序列化的工具,而在Android端则使用了其自定义的JSONUtil与StringCodec作为序列化工具。

  • StandardMessageCodec (默认如果不指定)

StandardMessageCodec 是BasicMessageChannel的默认编解码器,其支持基础数据类型、二进制数据、列表、字典。

MethodCodec 有多种不同实现

JSONMethodCodec

  • JSONMethodCodec的编解码依赖于JSONMessageCodec,当其在编码MethodCall时,会先将MethodCall转化为字典{“method”:method,”args”:args}。其在编码调用结果时,会将其转化为一个数组,调用成功为[result],调用失败为[code,message,detail]。再使用JSONMessageCodec将字典或数组转化为二进制数据。

StandardMethodCodec

  • MethodCodec的默认实现,StandardMethodCodec的编解码依赖于StandardMessageCodec,当其编码MethodCall时,会将method和args依次使用StandardMessageCodec编码,写入二进制数据容器。其在编码方法的调用结果时,若调用成功,会先向二进制数据容器写入数值0(代表调用成功),再写入StandardMessageCodec编码后的result。而调用失败,则先向容器写入数据1(代表调用失败),再依次写入StandardMessageCodec编码后的code,message和detail。

Flutter 开发 (3)Flutter 与 Native 的交互