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++类

flutter: 深入通信-接收端

相关推荐