Flutter 与原生通信

已于 2025-04-16 20:53:21 修改
阅读量1k 收藏 24
点赞数 23
分类专栏： Flutter笔记 flutte实践问题 文章标签： flutter android ios
于 2025-04-16 17:33:27 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_25218777/article/details/147281832
版权

Flutter 与原生之间的通信主要基于通道机制，包括 MethodChannel、EventChannel 和 BasicMessageChannel。

  • MethodChannel：用于 Flutter 与原生之间的方法调用，实现双向通信，适合一次性的方法调用并获取返回值，如 Flutter调用原生拍照功能并获取照片路径。
  • EventChannel：主要用于原生向 Flutter 发送数据流，例如原生端将传感器数据实时传递给 Flutter 端。
  • BasicMessageChannel：用于 Flutter 与原生之间传递字符串、二进制数据等基本类型的数据，可进行简单的数据交换。

1. Flutter 调用原生

Flutter 端代码

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Flutter 调用原生示例'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              const platform = MethodChannel('com.example.flutter_native');
              try {
                final String result = await platform.invokeMethod('getNativeMessage');
                print('原生返回的消息: $result');
              } on PlatformException catch (e) {
                print('调用原生方法失败: ${e.message}');
              }
            },
            child: const Text('调用原生方法'),
          ),
        ),
      ),
    );
  }
}

在 Flutter 端，创建 MethodChannel 实例，使用 invokeMethod 方法调用原生端的 getNativeMessage 方法，并处理返回结果。

安卓原生端代码（Kotlin）

package com.example.flutter_native

import android.os.Bundle
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.example.flutter_native"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "getNativeMessage") {
                result.success("这是来自安卓原生的消息")
            } else {
                result.notImplemented()
            }
        }
    }
}

在安卓端，创建 MethodChannel 实例，设置方法调用处理程序，当接收到 getNativeMessage 方法调用时，返回消息给 Flutter 端。

iOS 原生端代码（Swift）

import Flutter
import UIKit

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        let controller : FlutterViewController = window?.rootViewController as! FlutterViewController
        let channel = FlutterMethodChannel(name: "com.example.flutter_native", binaryMessenger: controller.binaryMessenger)
        channel.setMethodCallHandler { [weak self] (call: FlutterMethodCall, result: @escaping FlutterResult) in
            if call.method == "getNativeMessage" {
                result("这是来自 iOS 原生的消息")
            } else {
                result(FlutterMethodNotImplemented)
            }
        }
        GeneratedPluginRegistrant.register(with: self)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}

在 iOS 端，创建 FlutterMethodChannel 实例，设置方法调用处理程序，处理 getNativeMessage 方法调用并返回消息给 Flutter 端。

2. 原生调用 Flutter

Flutter 端代码

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    const platform = MethodChannel('com.example.native_flutter');
    platform.setMethodCallHandler((call) async {
      if (call.method == "getFlutterMessage") {
        return "这是来自 Flutter 的消息";
      }
      return null;
    });

    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('原生调用 Flutter 示例'),
        ),
        body: const Center(
          child: Text('等待原生调用...'),
        ),
      ),
    );
  }
}

在 Flutter 端，创建 MethodChannel 实例，使用 setMethodCallHandler 方法设置处理原生调用的回调，当接收到 getFlutterMessage 方法调用时，返回消息给原生端。

安卓原生端代码（Kotlin）

package com.example.native_flutter

import android.os.Bundle
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.example.native_flutter"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        val channel = MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL)
        channel.invokeMethod("getFlutterMessage", null) { result ->
            println("Flutter 返回的消息: $result")
        }
    }
}

在安卓端，创建 MethodChannel 实例，使用 invokeMethod 方法调用 Flutter 端的 getFlutterMessage 方法，并处理返回结果。

iOS 原生端代码（Swift）

import Flutter
import UIKit

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        let controller : FlutterViewController = window?.rootViewController as! FlutterViewController
        let channel = FlutterMethodChannel(name: "com.example.native_flutter", binaryMessenger: controller.binaryMessenger)
        channel.invokeMethod("getFlutterMessage", arguments: nil) { (result) in
            if let message = result as? String {
                print("Flutter 返回的消息: \(message)")
            }
        }
        GeneratedPluginRegistrant.register(with: self)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}

在 iOS 端，创建 FlutterMethodChannel 实例，使用 invokeMethod 方法调用 Flutter 端的 getFlutterMessage 方法，并处理返回结果。

3. EventChannel和BasicMessageChannel

EventChannel和BasicMessageChannel跟上面MethodChannel大同小异。

EventChannel

Flutter端

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    const eventChannel = EventChannel('com.example.event_channel');
    eventChannel.receiveBroadcastStream().listen((event) {
      print('接收到原生端的事件: $event');
    }, onError: (error) {
      print('接收事件时出错: $error');
    });

    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('EventChannel 示例'),
        ),
        body: const Center(
          child: Text('等待原生端发送事件...'),
        ),
      ),
    );
  }
}

在 Flutter 端，创建 EventChannel 实例，使用 receiveBroadcastStream 方法接收原生端发送的数据流，并通过 listen 方法监听事件。

安卓端

 package com.example.event_channel

import android.os.Bundle
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.EventChannel

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.example.event_channel"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        EventChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setStreamHandler(
            object : EventChannel.StreamHandler {
                private var eventSink: EventChannel.EventSink? = null

                override fun onListen(arguments: Any?, events: EventChannel.EventSink?) {
                    eventSink = events
                    // 模拟每隔 1 秒发送一个事件
                    val timer = android.os.Handler()
                    val runnable = object : Runnable {
                        var counter = 0
                        override fun run() {
                            eventSink?.success("事件 $counter")
                            counter++
                            timer.postDelayed(this, 1000)
                        }
                    }
                    timer.post(runnable)
                }

                override fun onCancel(arguments: Any?) {
                    eventSink = null
                }
            }
        )
    }
}

在安卓端，创建 EventChannel 实例，设置 StreamHandler，在 onListen 方法中模拟每隔 1 秒向 Flutter 端发送一个事件，在 onCancel 方法中取消事件发送。

iOS 原生端代码（Swift）

import Flutter
import UIKit

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        let controller : FlutterViewController = window?.rootViewController as! FlutterViewController
        let eventChannel = FlutterEventChannel(name: "com.example.event_channel", binaryMessenger: controller.binaryMessenger)
        eventChannel.setStreamHandler(
            MyStreamHandler()
        )
        GeneratedPluginRegistrant.register(with: self)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}

class MyStreamHandler: NSObject, FlutterStreamHandler {
    var eventSink: FlutterEventSink?
    var timer: Timer?

    func onListen(withArguments arguments: Any?, eventSink events: @escaping FlutterEventSink) -> FlutterError? {
        eventSink = events
        // 模拟每隔 1 秒发送一个事件
        timer = Timer.scheduledTimer(withTimeInterval: 1.0, repeats: true) { [weak self] _ in
            var counter = 0
            self?.eventSink?("事件 \(counter)")
            counter += 1
        }
        return nil
    }

    func onCancel(withArguments arguments: Any?) -> FlutterError? {
        timer?.invalidate()
        timer = nil
        eventSink = nil
        return nil
    }
}

在 iOS 端，创建 FlutterEventChannel 实例，设置 StreamHandler，在 onListen 方法中模拟每隔 1 秒向 Flutter 端发送一个事件，在 onCancel 方法中取消事件发送。

BasicMessageChannel

BasicMessageChannel 用于 Flutter 与原生之间传递字符串、二进制数据等基本类型的数据，是一种双向通信机制，适用于简单的数据交换场景，比如传递配置信息、状态信息等。双方可以互相发送和接收数据。

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    const messageChannel = BasicMessageChannel<String>('com.example.message_channel', StringCodec());
    messageChannel.send('来自 Flutter 的消息').then((reply) {
      if (reply != null) {
        print('收到原生端的回复: $reply');
      }
    });

    messageChannel.setMessageHandler((message) async {
      print('收到原生端的消息: $message');
      return 'Flutter 已收到消息';
    });

    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('BasicMessageChannel 示例'),
        ),
        body: const Center(
          child: Text('进行消息通信...'),
        ),
      ),
    );
  }
}

在 Flutter 端，创建 BasicMessageChannel 实例，使用 send 方法向原生端发送消息，并处理原生端的回复；使用 setMessageHandler 方法设置处理原生端发送消息的回调。

安卓原生端代码（Kotlin）

package com.example.message_channel

import android.os.Bundle
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.BasicMessageChannel
import io.flutter.plugin.common.StringCodec

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.example.message_channel"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        val messageChannel = BasicMessageChannel<String>(
            flutterEngine.dartExecutor.binaryMessenger,
            CHANNEL,
            StringCodec()
        )
        messageChannel.send("来自安卓原生的消息") { reply ->
            if (reply != null) {
                println("收到 Flutter 的回复: $reply")
            }
        }

        messageChannel.setMessageHandler { message, reply ->
            println("收到 Flutter 的消息: $message")
            reply.reply("安卓原生已收到消息")
        }
    }
}

在安卓端，创建 BasicMessageChannel 实例，使用 send 方法向 Flutter 端发送消息，并处理 Flutter 端的回复；使用 setMessageHandler 方法设置处理 Flutter 端发送消息的回调。

iOS 原生端代码（Swift）

import Flutter
import UIKit

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        let controller : FlutterViewController = window?.rootViewController as! FlutterViewController
        let messageChannel = FlutterBasicMessageChannel(name: "com.example.message_channel", binaryMessenger: controller.binaryMessenger, codec: FlutterStringCodec.sharedInstance())
        messageChannel.sendMessage("来自 iOS 原生的消息") { (reply) in
            if let replyMessage = reply as? String {
                print("收到 Flutter 的回复: \(replyMessage)")
            }
        }

        messageChannel.setMessageHandler { (message, reply) in
            if let message = message as? String {
                print("收到 Flutter 的消息: \(message)")
                reply("iOS 原生已收到消息")
            }
        }
        GeneratedPluginRegistrant.register(with: self)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}

在 iOS 端，创建 FlutterBasicMessageChannel 实例，使用 sendMessage 方法向 Flutter 端发送消息，并处理 Flutter 端的回复；使用 setMessageHandler 方法设置处理 Flutter 端发送消息的回调。

另外：采用信鸽pigeons三方库通信也是一个不错的选择

如何通过EventChannel实现Flutter与原生平台之间的双向通信
sg_knight的专栏
12-19 1287
EventChannel是实现Flutter和原生平台双向通信的有效工具。通过良好的协调，可以在两个平台之间流畅地传递事件数据。
Flutter 是如何与原生Android、iOS进行通信的？
cnzzs的博客
08-08 975
在Flutter应用中，与原生Android和iOS进行通信的主要方法是使用平台通道(Platform Channels)。平台通道允许Flutter代码与原生平台代码(如Java、Kotlin、Objective-C、Swift)相互调用，从而实现Flutter与原生代码之间的数据和功能交互。平台通道的基本概念平台通道的...
Flutter与原生通信
Ever69的博客
05-26 3546
—— Flutter作为一个跨平台框架，一经问世，便受到众多开发的追捧，发展至今相信已经有很多公司或个人将其加入自己的项目，进行混合开发，那么FLutter如何与原生通信呢？ —— 本次就以Android为例，介绍Flutter如何与Android之间进行通信，调用Android代码。 目录 MethodChannel Flutter端代码 Android端代码 Pigeon MethodChannel Flutter与原生之间通信是通过一个叫MethodChannel的东西来实现的，它的名
flutter 如何与原生框架通讯安卓 和 ios
zhangyihu321的专栏
03-12 746
1. 打开 `android/app/src/main/kotlin/com/example/your_app/MainActivity.kt`（或 `.java` 文件）。在上面的代码中，我们创建了一个名为 `com.example/native` 的通道，并定义了一个方法 `getNativeData`，它将调用原生代码。在 Flutter 中，平台通道的调用是异步的，因此您可以使用 `Future` 和 `async/await` 来处理结果。首先，在 Flutter 项目中创建一个平台通道。
Flutter 与 Android原生 相互通信：BasicMessageChannel、MethodChannel、EventChannel
Lan_Se_Tian_Ma的博客
01-21 3624
BasicMessageChannel主要应用于：传输数据；MethodChannel主要应用于：通过函数处理业务逻辑；EventChannel主要应用于：一些只能由原生端API才能完成的操作，处理完后发送给Flutter；和；。
Flutter开发之——Flutter与原生三种通信方式
我的博客
07-19 1917
一 概述 Flutter与Native原生端通信有三种方法： MethodChannel BasicMessageChannel EventChannel 二 三种通信方式介绍 2.1 MethodChannel Flutter与Native端相互调用，调用后返回结果 可以Native端主动调用，也可以Flutter主动调用，属于双向通信 此种方式最为常见，Native端调用需要在主线程中执行 2.2 BasicMessageChannel 用于使用指定的编解码器对消息进行编码和解码 属于双向通
Flutter中与原生的通信方式详解
datian1234的博客
03-21 1716
与MessageCodec不同的是，MethodCodec用于MethodCall对象的编解码，一个MethodCall对象代表一次从Flutter端发起的方法调用。MethodCall有2个成员变量：String类型的method代表需要调用的方法名称，通用类型(Android中为Object，iOS中为id)的arguments代表需要调用的方法入参
Flutter与原生代码通信
talk_8的专栏
10-03 1476
Flutter通过方法的参数给原生平台发送数据。原生平台通过方法的返回值给Flutter发送数据。这样便实现了双向通信功能。我在这里就不演示程序的运行结果了，建议大家自己动手去实现。不过我分享一些编译时的经验。编写channel中的代码时需要使用xCode打开flutter的项目；
【Flutter与原生通信内幕】：高效输入同步与遮挡问题解决
首先介绍了Flutter的基本概念和与原生通信的必要性，随后深入分析了Flutter架构、原生平台通信机制以及同步输入机制的理论。接着，通过实践案例，详细描述了如何搭建开发环境、建立基础通信和解决输入同步问题。文章...
Flutter学习笔记（六)Flutter与原生的互相通信
weixin_40929353的博客
10-29 996
我们既然使用Flutter作为UI技术框架，那么就少不了跟原生的通信（Android或者ios，方式类似，本文以Android为例）。 Flutter SDK中给我们提供了三个API,分别是MethodChannel、BasicMessageChannel、EventChannel。 1、MethodChannel 异步方法调用的方式使Flutter与原生相互通信。 1.1 Fl...
Flutter与原生通讯方式
weixin_37295261的博客
09-07 342
创建一个dart文件，命名pigeon/messages.dart，路径与lib并列/// 输出配置:/// 控制台执行：flutter pub run pigeon --input pigeons/messages.dart/// Description : 定义与原生通信--通过自动生成减少手写代码量/// 请求参数和返回结果都必需是类结构 否则无法生成文件),))//Flutter 调用 Native 方法@HostApi()//Native 调用 Flutter 方法。
Flutter 与原生交互 - android版
03-29
原生与Flutter数据交互，主要就是构建好通道机制  Flutter 与原生交互使用Platform Channel。Flutter定义了三种不同类型的Channel，它们分别是： BasicMessageChannel：用于传递字符串和半结构化的信息（双向有返回值）。 MethodChannel：用于传递方法调用（method invocation）（双向有返回值）。 EventChannel: 用于数据流（event streams）的通信（仅支持数据单向传递，无返回值）。 三种Channel之间互相独立，各有用途，但它们在设计上却非常相近。每种Channel均有三个重要成员变量： name:  String类型，代表Channel的名字，也是其唯一标识符。 messager：BinaryMessenger类型，代表消息信使，是消息的发送与接收的工具。 codec: MessageCodec类型或MethodCodec类型，代表消息的编解码器。
Flutter 与Android 原生通信的3种基本方式的使用
Sand哥的博客
04-10 1570
Flutter与Android原生通信的3种方式(附:Flutter 作为module嵌入Android原生项目)
Flutter与原生通信的一切
Android技术之家
09-15 871
简介Flutter与原生之间的通信依赖灵活的消息传递方式：应用的Flutter部分通过平台通道（platform channel）将消息发送到其应用程序的所在的宿主（iO...
Flutter快学快用24讲--21 原生通信：应用原生平台交互扩充 Flutter 基础能力
g_z_q_的博客
03-22 608
本课时核心是介绍了如何在 Flutter 中与原生平台进行通信，从而扩充 Flutter 基础功能，这部分还是需要有一定的原生编程能力。在掌握通信机制后，也顺便介绍了如何创建 Flutter plugin ，从而将多平台代码作为插件进行开发，而在 Flutter 端屏蔽多终端的问题。学完本课时以后，需要掌握 Flutter 与原生平台的通信方式，并且了解 Flutter plugin 的开发过程。
移动开发必备：Flutter 与原生交互方案
最新发布
移动开发前沿的博客
04-20 707
Flutter作为Google推出的跨平台UI框架，虽然提供了丰富的组件和功能，但在实际开发中仍然需要与原生平台进行交互。本文旨在全面解析Flutter与原生平台(iOS/Android)的交互方案，帮助开发者理解其工作原理并掌握最佳实践。本文涵盖从基础概念到高级应用的完整知识体系，包括平台通道机制、各种Channel的使用方法、性能优化策略以及实际项目中的应用案例。背景介绍：阐述Flutter与原生交互的必要性和基本概念核心概念与联系：解析平台通道机制和三种Channel的工作原理。
flutter与原生 相互通信实战
热门推荐
weixin_43575775的博客
10-18 1万+
ios 通信类 CommonUtil.swift。安卓 通信类 CommonUtil.java。swift调用flutter 进行通信。java调用与flutter通信。一、原生和flutter 通信。flutter 发送消息。
Flutter与Android通信开发指南
weixin_43901866的博客
09-15 620
想要成为一名优秀的Android开发，你需要一份完备的 知识体系，在这里，让我们一起成长为自己所想的那样~。 在做Flutter开发的时候通常离不了Flutter和Native之间的通信，比如：初始化Flutter时Native向Dart传递数据，Dart调用Native的相册选择图片，Dart调用Native的模块进行一些复杂的计算，Native将一些数据(GPS信息，陀螺仪，传感器等)主动传递给Dart等。 在这本篇文章中我将向大家分享在Flutter中Dart和Native之间通信的几种.
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

SY.ZHOU

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值