乐趣区

flutter-深入通信接收端

环境: flutter sdk v1.5.4-hotfix.1@stable

对应 flutter engine: 52c7a1e849a170be4b2b2fe34142ca2c0a6fea1f

前言

通过 PlatformChannel 为平台层作为接收端的例子我们已经了解到 DartMessenger 通过响应接口 handleMessageFromDart 来把 Dart 层的消息 / 操作发送到平台层,而这个方法是 PlatformMessageHandler 这个接口对象的,持有接口实例的对象正是FlutterJNI

作为被动调用的一方,平台层等待消息接收,并不知道消息的来源和用途,所以我们只需要按图索骥,找出调用方,就可追踪接收过程的完整流程。

追溯

容易看到 FlutterJN.handlePlatformMessage 调用了 handleMessageFromDart,此函数被标记成@SuppressWarnings("unused"),很大可能与 C ++ 层有关了,搜索方法名称果然在` 中找到“handlePlatformMessage”, 函数签名是“(Ljava/lang/String;[BI)V” 正是些方法,方法对象被全局变量 g_handle_platform_message_method 持有,又被FlutterViewHandlePlatformMessage` 引用,至此又进入到 C ++ 层。

这里 HandlePlatformMessage 这个名称实在太让人产生误解,感觉像是 C ++ 层在处理平台层发来的消息,然而实际却是传递 Dart 层的消息到平台,虽然 handlePlatformXXX 这种风格都表示处理 Dart 层的消息,并且保持的很好,但还是没有 receiveXXX 来的简单直观明了。

为便于理解以下是 被调用序列

DartMessenger.handleMessageFromDart => PlatformMessageHandler
  FlutterJNI.handlePlatformMessage => g_handle_platform_message_method
    FlutterViewHandlePlatformMessage 
      PlatformViewAndroid::HandlePlatformMessage <= PlatformView::HandlePlatformMessage
       ...Shell::OnEngineHandlePlatformMessage <= PlatformView::Delegate::OnEngineHandlePlatformMessage
         Engine::HandlePlatformMessage <= RuntimeDelegate::HandlePlatformMessage
           RuntimeController::HandlePlatformMessage <= WindowClient::HandlePlatformMessage
             ::SendPlatformMessage
             ...tonic::DartCallStatic(::_SendPlatformMessage
             ...Window::RegisterNatives

这与发送端的序列层次完全一样,从上到下分别是 Shell -> PlatformView -> Engine -> RuntimeController -> Window。

可知 FlutterViewHandlePlatformMessage 是 C ++ 调用的终点,全局变量 g_handle_platform_message_method 其实是平台 java 方法,所以需要知道 java 方法何时与 C ++ 方法关联起来的,即 g_handle_platform_message_method 何时被设置的:
以下是 被调用序列

g_handle_platform_message_method = env->GetMethodID(,"handlePlatformMessage",)
  ::RegisterApi
    PlatformViewAndroid::Register
      JNI_OnLoad
        System.loadLibrary("flutter") (library_loader.cc:23)
          FlutterMain.startInitialization (FlutterMain.java:161)
            FlutterApplication.onCreate (FlutterApplication.java:22)

JNI_OnLoad被声明在了链接器脚本 (android_exports.lst) 中,表示被加载时执行的操作。

结语

结合前 2 篇的调用细节分析(精确到函数),及一些关键类的创建时机做一个简明 flutter 通道数据通信类图如下:
左边是 java 类, 右边是 C ++ 类

退出移动版