引言:

经过前面章节的学习,相信读者已经对flutter有了一个整体的认识,并且也能利用flutter平台提供的一些基础组件自己写一些简单的页面逻辑,甚至有些读者可能已经在用纯flutter开发属于自己的app了,但是可能好多读者都会感觉到有些场景下或者说有些原生平台的东西从flutter端是无法获取的,比如系统版本、电池电量、动态权限申请等系统级的API,flutter并没有直接给我提供相关的API去操作,这个时候我们可能就需要通过借助Native的能力或者与原生平台交互来获取这些数据。

课程目标

  • 了解并掌握flutter与原生通信的方法
  • 掌握flutter与原生通过MethodChannel相互回调的实现机制
  • 掌握原生平台通过EventChannel主动向Flutter传递数据

1.Flutter与原生通信

flutter在与native端进行通信主要借助MethodChannel跟EventChannel建立连接,MethodChannel跟EventChannel就像管道或者桥梁一样,把flutter端跟native连接到一块。
我们来看下官方对此的解释:

A named channel for communicating with platform plugins using asynchronous method calls.

使用异步方法调用与平台插件通信的指定通道。

  • 1.)MethodChannel方法签名
  1. public MethodChannel(BinaryMessenger messenger, String name) {
  2. this(messenger, name, StandardMethodCodec.INSTANCE);
  3. }
  • 2.)EventChannel方法签名
  1. public EventChannel(BinaryMessenger messenger, String name) {
  2. this(messenger, name, StandardMethodCodec.INSTANCE);
  3. }

为了保证用户界面在交互过程中的流畅性,无论是从Flutter向Native端发送消息,还是Native向Flutter发送消息都是以异步的形式进行传递的。

1.在整个交互过程中,无论是Flutter端还是Native端都可以通过MethodChannel向对方平台发送两端提前定义好的方法名来调用对方平台相对应的消息处理逻辑并且带回返回值给被调用方。
2.而EventChannel的使用场景更侧重于Native平台主动向Flutter平台单向给Flutter平台发送消息,Flutter无法返回任何数据给Native端,笔者更愿意把EventChannel描述成是单通的。

到目前为止,我们已经简单的对flutter于native端的通信交互方式有了一个简单的了解,下面我们先来看贴上本节课程要完成的代码效果图,然后再对效果图中提到的案例逐个分析讲解:

19  Flutter与原生平台交互 - 图1

2.效果图代码案例分析
  • Flutter端通过MethodChannel调用Native平台弹出Toast
  • Flutter利用MechtondChannl向Natvie端传递参数调用Native端相关函数,Native接收参数后,并把处理完成后的结果返回给Flutter端。
  • Flutter端利用MethodChannel打开原生新页面
  • Native端利用MethodChannel传递参数到Flutter端,并接收从Flutter端传递回来的处理后到数据
  • Native端利用EventChannel主动向Flutter端发送数据(消息)

两端交互的方法注册逻辑也比较简单,读者一看便知,我就不过多展开描述,下面贴上关于两端交互的两个代表性的例子:

1.Flutter 调用原生函数,计算两个数的和并获取处理完成的结果到Flutter端
2.Native端利用EventChannel主动向Flutter端发送数据(消息)

2.1 Flutter 调用原生函数,计算两个数的和并获取处理完成的结果到Flutter端

场景分析 :可类比Flutter端处理不了的业务逻辑,这个时候把必要的参数传递给原生,原生处理接收到参数,处理完成后,再把结果回传到Flutter端,完成整个业务逻辑。

注册通道
为了保证用户界面在交互过程中的流畅性,无论是从Flutter向Native端发送消息,还是Native向Flutter发送消息都是以异步的形式进行传递的。

Native端:

  1. private static final String METHOD_CHANNEL = "com.zhuandian.flutter/android";
  2. methodChannel = new MethodChannel(getFlutterView(), METHOD_CHANNEL);

Flutter端:

  1. static final String METHOD_CHANNEL = "com.zhuandian.flutter/android";
  2. static final MethodChannel _MethodChannel =MethodChannel(METHOD_CHANNEL); //平台交互通道

Android端:

  1. public class MainActivity extends FlutterActivity {
  2. private static final String METHOD_CHANNEL = "com.zhuandian.flutter/android";
  3. private static final String METHOD_NUMBER_ADD = "numberAdd"; //简单加法计算,并返回两个数的和
  4. private MethodChannel methodChannel;
  5. @Override
  6. protected void onCreate(Bundle savedInstanceState) {
  7. super.onCreate(savedInstanceState);
  8. // setContentView(R.layout.activity_main);
  9. GeneratedPluginRegistrant.registerWith(this);
  10. methodChannel = new MethodChannel(getFlutterView(), METHOD_CHANNEL);
  11. //接受fltuter端传递过来的方法,并做出响应逻辑处理
  12. methodChannel.setMethodCallHandler(new MethodChannel.MethodCallHandler() {
  13. @Override
  14. public void onMethodCall(MethodCall call, MethodChannel.Result result) {
  15. System.out.println(call.method);
  16. if (call.method.equals(METHOD_NUMBER_ADD)) {
  17. int number1 = call.argument("number1");
  18. int number2 = call.argument("number2");
  19. result.success(number1 + number2); //返回两个数相加后的值
  20. }
  21. }
  22. });
  23. }
  24. }

Flutter 端:

  1. class AndroidPlatformPage extends StatefulWidget {
  2. @override
  3. State<StatefulWidget> createState() => PageState();
  4. }
  5. class PageState extends State<AndroidPlatformPage> {
  6. static final String METHOD_CHANNEL = "com.zhuandian.flutter/android";
  7. static final String NATIVE_METHOD_ADD = "numberAdd"; //原生android平台定义的供flutter端唤起的方法名
  8. static final MethodChannel _MethodChannel = MethodChannel(METHOD_CHANNEL); //平台交互通道
  9. @override
  10. Widget build(BuildContext context) {
  11. return Scaffold(
  12. appBar: AppBar(
  13. title: Text("平台交互"),
  14. centerTitle: true,
  15. ),
  16. body: Column(
  17. mainAxisAlignment: MainAxisAlignment.center,
  18. crossAxisAlignment: CrossAxisAlignment.stretch,
  19. children: <Widget>[
  20. RaisedButton(
  21. color: Colors.orangeAccent,
  22. child: Text("计算两个数的和"),
  23. onPressed: () {
  24. getNumberResult(25, 36);
  25. },
  26. ),
  27. ],
  28. ),
  29. );
  30. }
  31. /**
  32. * 调用平台方法计算两个数的和,并调用原生toast打印出结果
  33. */
  34. void getNumberResult(int i, int j) async {
  35. Map<String, dynamic> map = {"number1": 12, "number2": 43};
  36. int result = await _MethodChannel.invokeMethod(NATIVE_METHOD_ADD, map);
  37. print("调用原生平台计算后的结果为:${result}");
  38. }
  39. }

通过MethodChannel传递参数并且获取返回值,两端的执行逻辑完全一样,无论是从Flutter端回调Native端端数据,还是Native回调Flutter端数据都是先由被唤起端通过
methodChannel.setMethodCallHandlermethodChannel.invokeMethod(String method, [ dynamic arguments ]),一个负责处理回调,一个负责发送事件并且携带参数。

2.1.1事件接收处理端

接收处理回调时onMethodCall(MethodCall call, MethodChannel.Result result)通过methodCall接收事件发送者传递回来的信息,通过Result把处理完的结果发送给事件发送方。

  • 通过methodCall.method:来区分不同函数名(方法)名以执行不同的业务逻辑,
  • 通过methodCall.hasArgument("key"):判断是否有某个key对应的value
  • 通过methodCall.argument("key"):获取key对应的value值
  • 通过result.success(object):把处理完的结果返回给事件发送方

2.1.2事件发送端

处理事件发送方通过methodChannel.invokeMethod("方法名","要传递的参数")把需要传递的参数传递给事件监听者。
其中

  • 方法名:不能为空
  • 要传递的参数:可以为空,若不为空则必须为可Json序列化的对象。

然后监听者通过在setMethodCallHandler做出相关操作,对传递过来的参数做出相对于的逻辑处理后再把结果传递回来,以此完成整个平台交互过程。

上述例子flutter端作为事件发送方,Native端作为事件接收处理方,其实MethodChannel的设计完全可以让二者身份互换,即从Native端去发送消息到Flutter然后获取返回结果,实现的逻辑就是上述的逆过程,在真实开发中应用中笔者认为从原生端通过EventChannel主动向Flutter发消息的使用场景要远远多于 Native端通过MethodChannel回调去处理Flutter端的返回数据,所以就不单独在这里展开赘述 Native端通过MethodChannel回调去处理Flutter端返回的数据了,感兴趣的读者可以查看本篇博客配套代码中去查阅相关代码示例跟注释解读,下面我们来看下通过EventChannel主动向Flutter发消息的具体操作流程。

2.2 Native端利用EventChannel主动向Flutter端发送数据(消息)

场景分析:实现从Native端主动向Flutter端传递数据:页面成功渲染后从原生向Flutter端发送一个字符串显示在Flutter端端Text Widget上,当点击Flutter界面上的按钮后,调用原生的方法,主动向Flutter发送消息,更新Flutter端端UI显示。

效果图
19  Flutter与原生平台交互 - 图2

android端代码

  1. public class MainActivity extends FlutterActivity {
  2. private static final String METHOD_CHANNEL = "com.zhuandian.flutter/android";
  3. private static final String EVENT_CHANNEL = "com.zhuandian.flutter/android/event"; //事件通道,供原生主动调用flutter端使用
  4. private static final String METHOD_NATIVE_SEND_MESSAGE_FLUTTER = "nativeSendMessage2Flutter"; //原生主动向flutter发送消息
  5. private EventChannel.EventSink eventSink;
  6. private MethodChannel methodChannel;
  7. @Override
  8. protected void onCreate(Bundle savedInstanceState) {
  9. super.onCreate(savedInstanceState);
  10. GeneratedPluginRegistrant.registerWith(this);
  11. methodChannel = new MethodChannel(getFlutterView(), METHOD_CHANNEL);
  12. //接受fltuter端传递过来的方法,并做出响应逻辑处理
  13. methodChannel.setMethodCallHandler(new MethodChannel.MethodCallHandler() {
  14. @Override
  15. public void onMethodCall(MethodCall call, MethodChannel.Result result) {
  16. System.out.println(call.method);
  17. if (call.method.equals(METHOD_NATIVE_SEND_MESSAGE_FLUTTER)) {
  18. nativeSendMessage2Flutter();
  19. }
  20. }
  21. });
  22. new EventChannel(getFlutterView(), EVENT_CHANNEL).setStreamHandler(new EventChannel.StreamHandler() {
  23. @Override
  24. public void onListen(Object o, EventChannel.EventSink eventSink) {
  25. MainActivity.this.eventSink = eventSink;
  26. eventSink.success("事件通道准备就绪");
  27. //在此不建议做耗时操作,因为当onListen回调被触发后,在此注册当方法需要执行完毕才算结束回调函数
  28. //的执行,耗时操作可能会导致界面卡死,这里读者需注意!!
  29. }
  30. @Override
  31. public void onCancel(Object o) {
  32. }
  33. });
  34. }
  35. /**
  36. * 原生端向flutter主动发送消息;
  37. */
  38. private void nativeSendMessage2Flutter() {
  39. //主动向flutter发送一次更新后的数据
  40. eventSink.success("原生端向flutter主动发送消息");
  41. }
  42. }

Flutter端代码

  1. class AndroidPlatformPage extends StatefulWidget {
  2. @override
  3. State<StatefulWidget> createState() => PageState();
  4. }
  5. class PageState extends State<AndroidPlatformPage> {
  6. static final String METHOD_CHANNEL = "com.zhuandian.flutter/android";
  7. static final String EVENT_CHANNEL = "com.zhuandian.flutter/android/event";
  8. static final String NATIVE_SEND_MESSAGE_TO_FLUTTER =
  9. "nativeSendMessage2Flutter"; //原生主动向flutter发送消息
  10. static final MethodChannel _MethodChannel =
  11. MethodChannel(METHOD_CHANNEL); //平台交互通道
  12. static final EventChannel _EventChannel =
  13. EventChannel(EVENT_CHANNEL); //原生平台主动调用flutter端事件通道
  14. String _fromNativeInfo = "";
  15. @override
  16. void initState() {
  17. super.initState();
  18. _EventChannel.receiveBroadcastStream().listen(_onEvent, onError: _onErroe);
  19. }
  20. /**
  21. * 监听原生传递回来的值(通过eventChannel)
  22. */
  23. void _onEvent(Object object) {
  24. print(object.toString() + "-------------从原生主动传递过来的值");
  25. setState(() {
  26. _fromNativeInfo = object.toString();
  27. });
  28. }
  29. void _onErroe(Object object) {
  30. print(object.toString() + "-------------从原生主动传递过来的值");
  31. }
  32. @override
  33. Widget build(BuildContext context) {
  34. return Scaffold(
  35. appBar: AppBar(
  36. title: Text("平台交互"),
  37. centerTitle: true,
  38. ),
  39. body: Column(
  40. mainAxisAlignment: MainAxisAlignment.center,
  41. crossAxisAlignment: CrossAxisAlignment.stretch,
  42. children: <Widget>[
  43. Text("从原生平台主动传递回来的值"),
  44. Text(_fromNativeInfo),
  45. RaisedButton(
  46. color: Colors.orangeAccent,
  47. child: Text("点击调用原生主动向flutter发消息方法"),
  48. onPressed: () {
  49. _MethodChannel.invokeMethod(NATIVE_SEND_MESSAGE_TO_FLUTTER);
  50. },
  51. ),
  52. ],
  53. ),
  54. );
  55. }
  56. }

通过对比MethodChannle回调的形式传递数据,结合EventChannel从Native端主动向Flutter端发送数据我们可以发现后者更注重的监听,我们在Native端通过注册EventChannel对象后,然后通过 EventChannel.EventSinkvoid success(Object var1)方法向Flutter发送数据。

而Flutter端,我们通过在页面初始化端时候绑定监听对象

  1. @override
  2. void initState() {
  3. super.initState();
  4. _EventChannel.receiveBroadcastStream().listen(_onEvent, onError: _onErroe);
  5. }

并且通过 _onEvent监听从原生主动发送过来值,然后注册相应的处理。

  1. void _onEvent(Object object) {
  2. print(object.toString() + "-------------从原生主动传递过来的值");
  3. setState(() {
  4. _fromNativeInfo = object.toString();
  5. });
  6. }

限于篇幅问题,我在博文开头效果图里展示端代码就不逐一讲解效果图上的代码示例了完整的代码在本篇文章对应的源代码里都没有注释,读者可自行阅读配套源码结合代码里的注释自行测试。
平台交互部分完整代码:
Native端:https://github.com/xiedong11/flutter_app/blob/master/android/app/src/main/java/com/zhuandian/flutterapp/MainActivity.java
Flutter端:https://github.com/xiedong11/flutter_app/blob/master/lib/pages/platform/android_platform_page.dart