Flutter混编工程之高速公路Pigeon
点击上方蓝字关注我，知识会给你力量
前面我们讲到了Flutter与原生通信使用的是BasicMessageChannel，完全实现了接口解耦，通过协议来进行通信，但是这样的一个问题是，多端都需要维护一套协议规范，这样势必会导致协作开发时的通信成本，所以，Flutter官方给出了Pigeon这样一个解决方案。
Pigeon的存在就是为了解决多端通信的开发成本。其核心原理就是通过一套协议来生成多端的代码，这样多端只需要维护一套协议即可，其它代码都可以通过Pigeon来自动生成，这样就保证了多端的统一。
官方文档如下所示。
https://pub.flutter-io.cn/packages/pigeon/install
引入
首先，需要dev_dependencies中引入Pigeon：
dev_dependencies:pigeon: ^1.0.15接下来，在Flutter的lib文件夹同级目录下，创建一个.dart文件，例如schema.dart，这里就是通信的协议文件。
例如我们需要多端统一的一个实体：Book，如下所示。
import 'package:pigeon/pigeon.dart';class Book {String? title;String? author;
}@HostApi()
abstract class NativeBookApi {List<Book?> getNativeBookSearch(String keyword);void doMethodCall();
}这就是我们的协议文件，其中@HostApi，代表从Flutter端调用原生侧的方法，如果是@FlutterApi，那么则代表从原生侧调用Flutter的方法。
生成
执行下面的指令，就可以让Pigeon根据协议来生成相应的代码，下面的这些配置，需要指定一些文件目录和包名等信息，我们可以将它保存到一个sh文件中，这样更新后，只需要执行下这个sh文件即可。
flutter pub run pigeon \--input schema.dart \--dart_out lib/pigeon.dart \--objc_header_out ios/Runner/pigeon.h \--objc_source_out ios/Runner/pigeon.m \--java_out ./android/app/src/main/java/dev/flutter/pigeon/Pigeon.java \--java_package "dev.flutter.pigeon"这里面比较重要的就是导入schema.dart文件，作为协议，再指定Dart、iOS和Android代码的输出路径即可。
正常情况下，生成完后的代码就可以直接使用了。
❝
Pigeon生成的代码是Java和OC，主要是为了能够兼容更多的项目。你可以将它转化为Kotlin或者Swift。
❞
使用
就以上面这个例子，我们来看下如何根据Pigeon生成的代码来进行跨端通信。
首先，在Android代码中，会生成一个同名协议的接口，NativeBookApi，对应上面HostApi注解标记的协议名。在FlutterActivity的继承类中，创建这个接口的实现类。
private class NativeBookApiImp(val context: Context) : Api.NativeBookApi {override fun getNativeBookSearch(keyword: String?): MutableList<Api.Book> {val book = Api.Book().apply {title = "android"author = "xys$keyword"}return Collections.singletonList(book)}override fun doMethodCall() {context.startActivity(Intent(context, FlutterMainActivity::class.java))}
}这里顺便提一下，engine使用FlutterEngineGroup的方式进行创建，如果是其它方式，按照不同的方法获取engine对象即可。
class SingleFlutterActivity : FlutterActivity() {val engine: FlutterEngine by lazy {val app = activity.applicationContext as QDApplicationval dartEntrypoint =DartExecutor.DartEntrypoint(FlutterInjector.instance().flutterLoader().findAppBundlePath(), "main")app.engines.createAndRunEngine(activity, dartEntrypoint)}override fun configureFlutterEngine(flutterEngine: FlutterEngine) {super.configureFlutterEngine(flutterEngine)Api.NativeBookApi.setup(flutterEngine.dartExecutor, NativeBookApiImp(this))}override fun provideFlutterEngine(context: Context): FlutterEngine? {return engine}override fun onDestroy() {super.onDestroy()engine.destroy()}
}初始化Pigeon的核心方法就是NativeBookApi中的setup方法，传入engine和协议的实现即可。
接下来，我们来看下如何在Flutter中调用这个方法，在有Pigeon之前，我们都是通过Channel，创建String类型的协议名来通信的，现在有了Pigeon之后，这些容易出错的String就都被隐藏起来了，全部变成了正常的方法调用。
在Flutter中，Pigeon自动创建了NativeBookApi类，而不是Android中的接口，在类中已经生成了getNativeBookSearch和doMethodCall这些协议中定义的方法。
List<Book?> list = await api.getNativeBookSearch("xxx");
setState(() => _counter = "${list[0]?.title} ${list[0]?.author}");通过await就可以很方便的进行调用了。可见，通过Pigeon进行封装后，跨端通信完全被协议所封装了，同时也隐藏了各种String的处理，这样就进一步降低了人工出错的可能性。
优化
在实际的使用中，Flutter调用原生方法来获取数据，原生侧处理好数据后回传给Flutter，所以在Pigeon生成的Android代码中，协议函数的实现是一个带返回值的方法，如下所示。
override fun getNativeBookSearch(keyword: String?): MutableList<Api.Book> {val book = Api.Book().apply {title = "android"author = "xys$keyword"}return Collections.singletonList(book)
}这个方法本身没有什么问题，假如是网络请求，可以使用OKHttp的success和fail回调来进行处理，但是，如果要使用协程呢？
由于协程破除了回调，所以无法在Pigeon生成的函数中使用，这时候，就需要修改协议，给方法增加一个@async注解，将它标记为一个异步函数。
我们修改协议，并重新生成代码。
@HostApi()
abstract class NativeBookApi {@asyncList<Book?> getNativeBookSearch(String keyword);void doMethodCall();
}这时候你会发现，NativeBookApi的实现函数中，带返回值的函数已经变成了void，同时提供了一个result变量来处理返回值的传递。
override fun getNativeBookSearch(keyword: String?, result: Api.Result<MutableList<Api.Book>>?)这样使用就非常简单了，将返回值通过result塞回去就好了。
有了这个方法，我们就可以将Pigeon和协程配合起来使用，开发体验瞬间上升。
private class NativeBookApiImp(val context: Context, val lifecycleScope: LifecycleCoroutineScope) : Api.NativeBookApi {override fun getNativeBookSearch(keyword: String?, result: Api.Result<MutableList<Api.Book>>?) {lifecycleScope.launch {try {val data = RetrofitClient.getCommonApi().getXXXXList().dataval book = Api.Book().apply {title = data.tagList.toString()author = "xys$keyword"}result?.success(Collections.singletonList(book))} catch (e: Exception) {e.printStackTrace()}}}override fun doMethodCall() {context.startActivity(Intent(context, FlutterMainActivity::class.java))}
}协程+Pigeon YYDS。
❝
这里只介绍了Flutter调用Android的场景，实际上Android调用Flutter也只是换了个方向而已，代码都是类似的，这里不赘述了，那iOS呢？——我写Flutter，关iOS什么事。
❞
拆解
在了解了Pigeon如何使用之后，我们来看下，这只「鸽子」到底做了些什么。
从宏观上来看，不管是Dart端还是Android端，都是生成了三类东西。
数据实体类，例如上面的Book类
StandardMessageCodec，这是BasicMessageChannel的传输编码类
协议接口\类，例如上面的NativeBookApi
在Dart中，数据实体会自动帮你生成encode和decode的代码，这样你获取出来的数据就不再是Channel中的Object类型了，而是协议中定义的类型，极大的方便了开发者。
class Book {String? title;String? author;Object encode() {final Map<Object?, Object?> pigeonMap = <Object?, Object?>{};pigeonMap['title'] = title;pigeonMap['author'] = author;return pigeonMap;}static Book decode(Object message) {final Map<Object?, Object?> pigeonMap = message as Map<Object?, Object?>;return Book()..title = pigeonMap['title'] as String?..author = pigeonMap['author'] as String?;}
}在Android中，也是做的类似的操作，可以理解为用Java翻译了一遍。
下面是Codec，StandardMessageCodec是BasicMessageChannel的标准编解码器，传输的数据需要实现它的writeValue和readValueOfType方法。
class _NativeBookApiCodec extends StandardMessageCodec {const _NativeBookApiCodec();@overridevoid writeValue(WriteBuffer buffer, Object? value) {if (value is Book) {buffer.putUint8(128);writeValue(buffer, value.encode());} else {super.writeValue(buffer, value);}}@overrideObject? readValueOfType(int type, ReadBuffer buffer) {switch (type) {case 128: return Book.decode(readValue(buffer)!);default: return super.readValueOfType(type, buffer);}}
}同样的，Dart和Android代码几乎一致，也很好理解，毕竟是一套协议，规则是一样的。
下面就是Pigeon的核心了，我们来看具体的协议是如何实现的，首先来看下Dart中是如何实现的，由于我们是从Flutter中调用Android中的代码，所以按照Channel的原理来说，我们需要在Dart中申明一个Channel，并处理其返回的数据。
如果你熟悉Channel的使用，那么这段代码应该是比较清晰的。
下面再来看看Android中的实现。Android侧是事件的处理者，所以需要实现协议的具体内容，这就是我们前面实现的接口，另外，还需要添加setMessageHandler来处理具体的协议。
这里有点意思的地方是那个Reply类的封装。
public interface Result<T> {void success(T result);void error(Throwable error);
}前面我们说了，在Pigeon中可以通过@async来生成异步接口，这个异步接口的实现，实际上就是这里处理的。
看到这里，你应该几乎就了解了Pigeon到底是如何工作的了，说白了实际上就是通过build_runner来生成这些代码，把脏活累活都自己吞下去了，我们看见的，实际上就是具体协议类的实现和调用。
题外话
所以说，Pigeon并不是什么非常高深的内容，但却是Flutter混编的一个非常重要的思想，或者说是Flutter团队的一个指导思想，那就是通过「协议」「模板」来生成相关的代码，类似的还有JSON解析的例子，实际上也是如此。
再讲的多一点，Android模块之间的解耦、模块化操作，实际上是不是也能通过这种方式来处理呢？所以说，大道至简，殊途同归，软件工程做到最后，实际上思想都是类似的，万物斗转星移，唯有思想永恒。
向大家推荐下我的网站 https://xuyisheng.top/ 点击原文一键直达
专注 Android-Kotlin-Flutter 欢迎大家访问
往期推荐
flutter与compose的爱恨情仇
Flutter混编工程之通讯之路
闲言碎语——第四期
闲言碎语—年终总结
本文原创公众号：群英传，授权转载请联系微信(Tomcat_xu)，授权后，请在原创发表24小时后转载。
< END >
作者：徐宜生
更文不易，点个“三连”支持一下
背景 目前准备试水 Flutter,但是多数native开发是不了解Flutter,因此需要设计一种比较"舒服"的集成方式. 混编方案 方案考量 如果直接采用 Flutter 工程 ... 1.关闭bitcode 2.File -> WorkSpace Setting -> Legacy build system 3.若是插件中有swift实现的,但是原项目中是纯OC,可以新 ... 前言 上半年我定的OKR目标是帮助团队将App切入Flutter,实现统一技术栈,变革成多端融合开发模式.Flutter目前是跨平台方案中最有潜力实现我们这个目标的,不管是Hybird还是React ... 前言 Flutter和iOS支持两种形式的混编,一种是某一些页面全是用flutter去绘制,另外一只是flutter页面作为iOS某个控制器页面的一部分去展示,后面会逐步去介绍这两种方式的实现 本篇文 ... 最近工作需要,需要制作一些静态库.由于缺乏经验,特意找了一些资料,加上自己的测试.特意在此记录一些心得和踩过的坑.所谓"好记性不如烂笔头",希望自己以后忘记的时候能回头来看看,同时 ... flutter和Android混编下出现"No implementation found for method xxxx on channel"错误 这个错误出现的原因是Plugi ... 背景 本文我们将开一下脑洞,在 Flutter 工程基础上下集成及运行小程序方案. 先看一下效果如下: 新建 Flutter 样例工程 Flutter 的安装 Flutter 的安装可参考https: ... 背景 本文我们将开一下脑洞,在 Flutter 工程基础上下集成及运行小程序方案. 先看一下效果如下: 新建 Flutter 样例工程 Flutter 的安装 Flutter 的安装可参考https: ... 一.运行Xcode编译或者flutter run/build 过程中报错:"x86_64" is not an allowed value for option "ios ... 作者丨郭金.陈佳 来源丨百度App技术 一. 背景 1.1 Swift 发展历史 2010 年 7 月,克里斯(Chris Lattner)开始设计 Swift.完成基础架构后,克里斯带领开发小组陆续 ...Flutter混编工程之高速公路Pigeon相关推荐
最新文章
热门文章