允许开发者使用一套代码库为

提供了丰富的组件和库某些情况下开发者可能仍需要使用平台特有的功能或集成现有的原生页面和服务。

与原生页面交互显得尤为重要

实现可能不现实或成本过高。

调用平台特有的API一些平台特有的API如支付、地图等只能通过原生代码访问。

集成第三方原生库一些第三方库只提供原生的接口需要通过原生代码来集成。

性能关键任务对于一些性能敏感的任务原生代码往往可以提供更好的性能表现。

遵循平台设计规范有时为了保持应用的一致性需要使用原生组件来遵守特定平台的设计规范。

开发者可以充分利用平台的能力同时保持应用的流畅性和用户体验的一致性。

二、基本概念

平台通道是Flutter中一个强大的机制它允许Flutter与宿主平台如Android和iOS进行数据和任务的双向通信。

这种机制解决了Flutter无法直接调用平台特定API的限制使得Flutter应用能够实现原生平台的功能。

平台通道通过使用一个消息传递的系统工作该系统包括以下三个关键概念

消息传递的数据单元可以是简单的字符串、数字或者更复杂的序列化数据结构。

编解码器负责消息的序列化与反序列化。

Flutter提供了几种标准的编解码器例如JSONMessageCodec、StandardMessageCodec、StringCodec和BinaryCodec。

通道连接Flutter和原生平台代码的通信通道。

Flutter提供了三种类型的平台通道每种通道都适合不同的应用场景

MethodChannel用于传递方法调用及其响应。

方法调用是单次的通常用于执行原生操作并获取结果。

EventChannel用于创建一个数据流它允许原生代码发送连续的事件数据给Flutter。

这适合于监听原生端的事件或数据变化如传感器数据或用户位置更新。

BasicMessageChannel用于传递没有固定响应的消息支持自定义的编解码器。

这适合于双向通信比如状态同步或数据共享。

(3).序列化机制

由于消息需要在Flutter和原生代码之间传递所以它们需要被序列化转换为字节序列和反序列化。

Flutter框架提供了几个内置的编解码器来处理常见的数据类型开发者也可以自定义编解码器。

使用平台通道时通常需要在Flutter端和原生端同时进行代码编写。

Flutter端

package:flutter/services.dart;class

BatteryLevel

MethodChannel(com.example.battery);static

Futureint

_channel.invokeMethod(getBatteryLevel);return

batteryLevel;}

configureFlutterEngine(flutterEngine:

FlutterEngine)

{super.configureFlutterEngine(flutterEngine)MethodChannel(flutterEngine.dartExecutor.binaryMessenger,

{call,

{result.notImplemented()}}}private

fun

getSystemService(Context.BATTERY_SERVICE)

batteryManager.getIntProperty(BatteryManager.BATTERY_PROPERTY_CAPACITY)}

else

ContextWrapper(applicationContext).registerReceiver(null,

IntentFilter(Intent.ACTION_BATTERY_CHANGED))batteryLevel

intent!!.getIntExtra(BatteryManager.EXTRA_LEVEL,

-1)

intent.getIntExtra(BatteryManager.EXTRA_SCALE,

-1)}return

UIApplication,didFinishLaunchingWithOptions

launchOptions:

[UIApplication.LaunchOptionsKey:

Any]?)

{GeneratedPluginRegistrant.register(with:

self)let

batteryChannel,binaryMessenger:

controller.binaryMessenger)methodChannel.setMethodCallHandler({[weak

self]

{result(FlutterMethodNotImplemented)return}self?.receiveBatteryLevel(result:

result)})return

UIDevice.currentdevice.isBatteryMonitoringEnabled

trueif

{result(Int(device.batteryLevel

100))}}

在Flutter中MethodChannel、EventChannel和BasicMessageChannel是三种不同的平台通道用于实现Dart代码和原生平台代码之间的通信。

MethodChannel

MethodChannel通常用于发送方法调用请求并接收单次响应。

它适合于执行原生操作并获取结果的场景。

Flutter端

package:flutter/services.dart;//

创建MethodChannel实例

MethodChannel(com.example.channel/method);//

调用原生方法并获取电池电量

methodChannel.invokeMethod(getBatteryLevel);return

result;}

io.flutter.embedding.android.FlutterActivity

import

io.flutter.embedding.engine.FlutterEngine

import

io.flutter.plugin.common.MethodChannelclass

MainActivity:

com.example.channel/methodoverride

fun

configureFlutterEngine(flutterEngine:

FlutterEngine)

{super.configureFlutterEngine(flutterEngine)//

创建MethodChannel实例并设置方法调用处理器MethodChannel(flutterEngine.dartExecutor.binaryMessenger,

call,

com.example.channel/methodoverride

func

UIApplication,didFinishLaunchingWithOptions

launchOptions:

[UIApplication.LaunchOptionsKey:

Any]?)

{GeneratedPluginRegistrant.register(with:

self)guard

methodChannelName,binaryMessenger:

controller.binaryMessenger)methodChannel.setMethodCallHandler({[weak

self]

执行获取电池电量的操作并将结果返回给Flutter端self?.receiveBatteryLevel(result:

result)}

{result(FlutterMethodNotImplemented)}})return

func

这里只是一个示例实际获取电池电量的方法与此不同result(100)

EventChannel

streams可以用来监听原生端发出的事件。

例如原生端的传感器数据或数据库更新。

Flutter端

package:flutter/services.dart;//

创建EventChannel实例

EventChannel(com.example.channel/stream);//

void

{eventChannel.receiveBroadcastStream().listen((event)

{//

io.flutter.embedding.android.FlutterActivity

import

io.flutter.embedding.engine.FlutterEngine

import

io.flutter.plugin.common.EventChannel

import

configureFlutterEngine(flutterEngine:

FlutterEngine)

{super.configureFlutterEngine(flutterEngine)//

创建EventChannel实例并设置事件流处理器EventChannel(flutterEngine.dartExecutor.binaryMessenger,

CHANNEL).setStreamHandler(object

{override

设置定时器模拟传送传感器数据sensorDataStream.schedule(object

TimerTask()

模拟事件数据这里发送当前时间戳events?.success(System.currentTimeMillis())}},

1000)}override

取消事件流sensorDataStream.cancel()}})}

iOS端Swift

Timer.scheduledTimer(withTimeInterval:

1.0,

模拟事件数据这里发送当前时间戳events(Date().timeIntervalSince1970

1000)}return

com.example.channel/streamoverride

func

UIApplication,didFinishLaunchingWithOptions

launchOptions:

[UIApplication.LaunchOptionsKey:

Any]?)

{GeneratedPluginRegistrant.register(with:

self)let

StreamHandler()eventChannel.setStreamHandler(streamHandler)return

launchOptions)}

允许发送和接收字符串和半结构化信息适用于自定义编码和协议或者需要频繁通信但数据量不大的场景。

Flutter端

package:flutter/services.dart;//

basicMessageChannel

BasicMessageChannelString(com.example.channel/basic,

StringCodec());//

basicMessageChannel.send(message);print(Received

response:

{basicMessageChannel.setMessageHandler((String

message)

io.flutter.embedding.android.FlutterActivity

import

io.flutter.embedding.engine.FlutterEngine

import

io.flutter.plugin.common.BasicMessageChannel

import

io.flutter.plugin.common.StringCodecclass

MainActivity:

com.example.channel/basicoverride

fun

configureFlutterEngine(flutterEngine:

FlutterEngine)

{super.configureFlutterEngine(flutterEngine)//

messageChannel

BasicMessageChannelString(flutterEngine.dartExecutor.binaryMessenger,

CHANNEL,

设置消息接收器messageChannel.setMessageHandler

message,

在这里处理从Flutter接收到的消息println(Received

message:

com.example.channel/basicoverride

func

UIApplication,didFinishLaunchingWithOptions

launchOptions:

[UIApplication.LaunchOptionsKey:

Any]?)

{GeneratedPluginRegistrant.register(with:

self)guard

FlutterBasicMessageChannel(name:

basicMessageChannelName,binaryMessenger:

controller.binaryMessenger,codec:

FlutterStringCodec.sharedInstance())//

设置消息接收器messageChannel.setMessageHandler

(message:

在Flutter中平台通道的调用通常是异步的这意味着你可以使用async和await关键字来等待原生代码的执行结果而不会阻塞UI线程。

例如使用MethodChannel请求电池电量时你通常会这样做

Futurevoid

NativeBridge.getBatteryLevel();batteryLevel

Battery

平台通道这个通道将用于Flutter与原生平台iOS和Android之间的通信。

2.在

package:flutter/services.dart;//

const

MethodChannel(com.example.channel/method);//

调用原生方法

platformChannel.invokeMethod(getNativeData);print(从原生平台获取的数据$result);}

PlatformException

{print(调用原生平台方法失败${e.message});}

MethodChannel

io.flutter.embedding.android.FlutterActivity

import

io.flutter.embedding.engine.FlutterEngine

import

io.flutter.plugin.common.MethodCall

import

io.flutter.plugin.common.MethodChannel

import

io.flutter.plugin.common.MethodChannel.MethodCallHandlerclass

MainActivity:

com.example.channel/methodoverride

fun

configureFlutterEngine(flutterEngine:

FlutterEngine)

{super.configureFlutterEngine(flutterEngine)//

设置MethodChannel并监听来自Flutter的调用MethodChannel(flutterEngine.dartExecutor.binaryMessenger,

call,

使用result对象发送结果回Flutterresult.success(nativeData)}

else

如果方法未实现返回未实现的错误result.notImplemented()}}}

在这段代码中我们在

com.example.channel/methodoverride

func

UIApplication,didFinishLaunchingWithOptions

launchOptions:

[UIApplication.LaunchOptionsKey:

Any]?)

{GeneratedPluginRegistrant.register(with:

self)guard

设置监听器以处理来自Flutter的方法调用channel.setMethodCallHandler

{(call:

发送结果回Flutterresult(nativeData)}

else

如果方法未实现返回未实现的错误result(FlutterMethodNotImplemented)}}return

launchOptions)}

为了实现Flutter跳转到原生页面的功能我们需要在三个平台上编写相应的代码Flutter、iOS和Android。

Flutter端

在Flutter端我们使用MethodChannel来发起跳转到原生页面的请求。

import

package:flutter/services.dart;void

main()

创建MethodChannel实例通道名称要与原生端一致static

const

MethodChannel(com.example.channel/native);//

openNativeScreen()

platformChannel.invokeMethod(openNativeScreen);}

PlatformException

在上面的Flutter代码中我们定义了一个按钮当用户点击这个按钮时openNativeScreen函数会通过MethodChannel发起一个名为openNativeScreen的方法调用。

Android端Kotlin

在Android端在MainActivity中监听MethodChannel并对openNativeScreen方法调用进行处理启动一个新的Activity。

MainActivity.kt

io.flutter.embedding.android.FlutterActivity

import

io.flutter.embedding.engine.FlutterEngine

import

io.flutter.plugin.common.MethodChannelclass

MainActivity:

com.example.channel/nativeoverride

fun

configureFlutterEngine(flutterEngine:

FlutterEngine)

{super.configureFlutterEngine(flutterEngine)MethodChannel(flutterEngine.dartExecutor.binaryMessenger,

call,

NativeActivity::class.java)startActivity(intent)//

else

androidx.appcompat.app.AppCompatActivity//

class

{super.onCreate(savedInstanceState)//

设置原生页面的布局setContentView(R.layout.activity_native)}

在Android项目中我们还需要在AndroidManifest.xml中注册NativeActivity。

activity

在iOS端在AppDelegate中监听MethodChannel并对openNativeScreen方法调用进行处理启动一个新的UIViewController。

import

com.example.channel/nativeoverride

func

UIApplication,didFinishLaunchingWithOptions

launchOptions:

[UIApplication.LaunchOptionsKey:

Any]?)

{GeneratedPluginRegistrant.register(with:

self)if

controller.binaryMessenger)channel.setMethodCallHandler

(call:

实现UIViewController的跳转逻辑self.openNativeScreen(from:

else

{result(FlutterMethodNotImplemented)}}}return

func

从当前FlutterViewController进行页面跳转flutterViewController.present(nativeViewController,

animated:

设置原生页面的属性例如背景色view.backgroundColor

UIColor.white}

为了实现从Flutter应用传递数据到原生页面并在原生页面中接收和解析这些数据我们需要分别在Flutter、Android和iOS端编写代码。

Flutter端发送数据

创建MethodChannel实例通道名称要与原生端一致static

const

MethodChannel(com.example.channel/transfer);//

sendSimpleData()

platformChannel.invokeMethod(sendSimpleData,

{message:

platformChannel.invokeMethod(sendComplexData,

{data:

json.encode(complexData)});print(response);

PlatformException

MainAxisAlignment.center,children:

Widget[ElevatedButton(onPressed:

Text(Send

Data),),ElevatedButton(onPressed:

Text(Send

在Flutter端我们创建了两个函数sendSimpleData和sendComplexData用于发送简单和复杂数据。

数据通过MethodChannel的invokeMethod函数发送到原生端同时可以从原生端接收响应。

Android端Kotlin

在Android端我们监听MethodChannel并使用Gson库来解析JSON格式的复杂数据。

MainActivity.kt

androidx.appcompat.app.AppCompatActivity

import

io.flutter.embedding.android.FlutterActivity

import

io.flutter.embedding.engine.FlutterEngine

import

io.flutter.plugin.common.MethodChannel

import

com.google.gson.reflect.TypeTokenclass

MainActivity:

com.example.channel/transferoverride

fun

configureFlutterEngine(flutterEngine:

FlutterEngine)

{super.configureFlutterEngine(flutterEngine)MethodChannel(flutterEngine.dartExecutor.binaryMessenger,

call,

发送响应回Flutter端result.success(Received

simple

发送响应回Flutter端result.success(Received

complex

在iOS端我们监听MethodChannel并使用Swift的Codable协议或JSONSerialization来解析JSON格式的复杂数据。

AppDelegate.swift

com.example.channel/transferoverride

func

UIApplication,didFinishLaunchingWithOptions

launchOptions:[UIApplication.LaunchOptionsKey:

Any]?)

{GeneratedPluginRegistrant.register(with:

self)guard

controller.binaryMessenger)channel.setMethodCallHandler

[weak

JSONDecoder().decode(User.self,

from:

nil))}default:result(FlutterMethodNotImplemented)}}return

launchOptions)}

当需要从原生页面回传数据到Flutter时有两种常见的方法使用MethodChannel或者使用ActivityResultAndroid端/使用委托(delegate)/闭包(closures)iOS端。

使用MethodChannel回传数据此方法适用于任何时候原生代码需要主动发送数据到Flutter端的情况不仅限于页面返回时。

Flutter端通过MethodChannel与原生代码通信可以接收来自原生端的数据。

使用ActivityResultAndroid/闭包和协议委托iOS此方法一般用于原生页面关闭时将数据回传到Flutter端。

在Android上可以通过setResult方法和Intent返回数据给前一个Activity。

在iOS上可以通过代理模式或闭包将数据回传给之前的控制器。

在Flutter端我们需要设置好MethodChannel监听原生端发来的数据或者在启动原生页面时等待结果。

Flutter端设置了MethodChannel监听并处理原生端的调用当原生代码处理完毕后通过相同的MethodChannel返回结果。

这是一种典型的RPC远程过程调用模式。

单次请求-响应模式Flutter发起调用原生端返回数据通信完成。

Flutter端主动请求Flutter通过invokeMethod主动请求原生数据。

异步等待原生端响应Flutter调用后使用await关键字等待原生端完成操作并返回结果。

适用场景当Flutter需要原生端某个特定操作的结果时使用比如获取设备信息、处理完毕的数据等。

Flutter端接收返回数据

package:flutter/services.dart;class

HomeScreen

创建一个MethodChannel用于与原生平台通信static

const

MethodChannel(com.example.channel/transfer);//

_dataFromNative

中设置监听器以处理原生平台发来的方法调用platformChannel.setMethodCallHandler(_handleMethodCall);}//

call)

call.arguments;});break;default:throw

MissingPluginException(notImplemented);}}overrideWidget

build(BuildContext

在Android端你可以在MainActivity中创建一个按钮并在点击事件中使用MethodChannel向Flutter发送消息

...其他导入

io.flutter.embedding.android.FlutterActivity

import

io.flutter.plugin.common.MethodChannelclass

MainActivity:

com.example.channel/transferoverride

fun

{super.onCreate(savedInstanceState)//

初始化MethodChannelval

MethodChannel(flutterEngine!!.dartExecutor.binaryMessenger,

CHANNEL)//

使用MethodChannel调用Flutter端定义的方法并传递数据channel.invokeMethod(onDataReturn,

假设有个触发发送数据到Flutter的逻辑sendDataToFlutter()}

iOS端Swift设置返回数据

在iOS端你可以在ViewController中为一个按钮并在这个按钮回调中使用MethodChannel向Flutter发送消息

...其他导入

使用MethodChannel调用Flutter端定义的方法并传递数据channel?.invokeMethod(onDataReturn,

arguments:

假设有个触发发送数据到Flutter的逻辑sendDataToFlutter()}

方式二事件订阅模式

是一种事件订阅模式Flutter端通过MethodChannel设置监听器任何时候原生端都可以主动调用这个通道并发送数据到Flutter而Flutter端则在_listener_方法中处理所有接收到的消息。

持续监听模式Flutter监听原生端的方法调用原生端可以在任何时刻主动发送消息。

原生端主动发送消息原生代码在适当的时候如某事件发生后主动调用MethodChannel向Flutter发送消息。

适用场景对于原生端事件的实时监听和处理如位置更新、传感器数据等。

Flutter端接收返回数据

package:flutter/services.dart;class

HomeScreen

MethodChannel(com.example.channel/transfer);//

_navigateAndDisplaySelection(BuildContext

context)

platformChannel.invokeMethod(startNativeView);//

使用返回结果更新UI或状态if

{ScaffoldMessenger.of(context).showSnackBar(SnackBar(content:

build(BuildContext

_navigateAndDisplaySelection(context),child:

Text(打开原生页面),),),);}

在上面的Flutter端代码中我们通过platformChannel.invokeMethod调用原生端的方法打开一个原生页面并使用await关键字等待异步结果。

当原生页面关闭并返回数据时我们可以通过result变量接收这个数据并通过ScaffoldMessenger显示在一个SnackBar中。

Android端Kotlin设置返回数据

在Android端我们可以使用setResult方法和Intent回传数据。

原生页面Activity

{super.onCreate(savedInstanceState)//

设置布局、初始化等操作//

findViewByIdButton(R.id.button_id)button.setOnClickListener

{val

Intent()returnIntent.putExtra(result_key,

这里是从原生返回的数据)setResult(Activity.RESULT_OK,

在Android原生端你需要定义一个MethodChannel并监听startNativeView方法调用然后打开一个新的Activity并在关闭时设置返回结果

MainActivity.kt

io.flutter.embedding.android.FlutterActivity

import

io.flutter.embedding.engine.FlutterEngine

import

io.flutter.plugin.common.MethodChannelclass

MainActivity:

com.example.channel/transferoverride

fun

configureFlutterEngine(flutterEngine:

FlutterEngine)

{super.configureFlutterEngine(flutterEngine)MethodChannel(flutterEngine.dartExecutor.binaryMessenger,

{call,

NativeActivity::class.java)startActivityForResult(intent,

REQUEST_CODE)}

{super.onActivityResult(requestCode,

resultCode,

data?.getStringExtra(result_key)

data//

使用MethodChannel返回数据到FlutterMethodChannel(flutterEngine.dartExecutor.binaryMessenger,

CHANNEL).invokeMethod(onDataReturn,

object

UIButton()button.addTarget(self,

action:

当按钮被点击时通过闭包传递数据回Flutter端onReturnData?(这里是从原生返回的数据)dismiss(animated:

true,

在iOS原生端你需要在Flutter与原生端之间建立一个MethodChannel并监听Flutter端的调用然后打开一个新的ViewController并在关闭时回传数据

AppDelegate.swift

UIApplication,didFinishLaunchingWithOptions

launchOptions:

[UIApplication.LaunchOptionsKey:

Any]?)

com.example.channel/transfer,binaryMessenger:

controller.binaryMessenger)channel.setMethodCallHandler({[weak

self]

保存FlutterResult回调self?.flutterResult

result//

{result(FlutterMethodNotImplemented)}})}return

func

设置回调闭包以便在ViewController关闭时返回数据nativeViewController.onReturnData

[weak

inself?.flutterResult?(data)}//

展示原生ViewControllercontroller.present(nativeViewController,

animated:

错误处理是编写健壮软件的重要组成部分。

下面将详细介绍如何在Flutter、AndroidKotlin、iOSSwift三个平台上进行错误处理和异常安全。

我们在Flutter端通过MethodChannel调用原生代码并且在原生端使用try-catchKotlin或do-try-catchSwift来捕获可能发生的异常。

如果捕获到异常原生端会通过MethodChannel.ResultKotlin或FlutterResultSwift将错误信息传递回Flutter。

异常处理机制确保了当原生代码执行出错时Flutter端可以收到错误信息并且可以根据错误信息做出相应的处理从而提供更加健壮的用户体验。

在Flutter端我们可以通过try-catch块来捕获和处理通过MethodChannel调用原生代码时可能抛出的异常。

import

package:flutter/services.dart;class

extends

{override_ExceptionHandlingScreenState

createState()

_ExceptionHandlingScreenState();

}class

MethodChannel(com.example.channel/methods);String

_result

platformChannel.invokeMethod(methodName);setState(()

{_result

未知异常${e.toString()};});}}overrideWidget

build(BuildContext

MainAxisAlignment.center,children:

Widget[ElevatedButton(onPressed:

_invokeNativeMethod(someMethod),child:

Text(调用原生方法),),Padding(padding:

const

在AndroidKotlin端我们可以使用try-catch块来处理可能在执行方法调用时发生的异常并通过MethodChannel.Result向Flutter端传递错误信息。

MainActivity.kt

io.flutter.embedding.android.FlutterActivity

import

io.flutter.embedding.engine.FlutterEngine

import

io.flutter.plugin.common.MethodChannelclass

MainActivity

com.example.channel/methodsoverride

fun

configureFlutterEngine(flutterEngine:

FlutterEngine)

{super.configureFlutterEngine(flutterEngine)MethodChannel(flutterEngine.dartExecutor.binaryMessenger,

call,

你的原生方法处理result.success(从原生返回的数据)}else

catch

捕获异常并将错误返回到Flutterresult.error(ERROR,

方法执行出错:

在iOSSwift端我们一般通过do-try-catch块来处理方法调用时可能抛出的异常并通过FlutterResult传递错误信息给Flutter端。

AppDelegate.swift

com.example.channel/methodsoverride

func

UIApplication,didFinishLaunchingWithOptions

launchOptions:

[UIApplication.LaunchOptionsKey:

Any]?)

controller.binaryMessenger)channel.setMethodCallHandler

(call,

self.someNativeMethod()result(data)}

catch

如果有异常将异常信息返回给Flutterresult(FlutterError(code:

ERROR,message:

\(error.localizedDescription),details:

nil))}}

{result(FlutterMethodNotImplemented)}}return

func