1. 前言
在 Flutter 开发中，虽然 Dart 能够胜任大部分 UI 开发，但在涉及 底层硬件调用（如传感器、蓝牙）、第三方原生 SDK 集成、或系统级 API 时，我们必须与 Android 原生（Java/Kotlin）进行通信。
Flutter 官方提供了一套名为 Platform Channels 的机制，它就像一座桥梁，让消息在 Dart 和原生代码之间高效传递。
2. Platform Channel 架构原理
Flutter 与 Android 的通信本质上是基于消息传递的异步通信。
-
Flutter (Client)：通过 Dart 调用接口发送消息。
-
Android (Host)：接收消息，并在主线程（UI Thread）中执行原生逻辑。
-
BinaryMessenger：底层负责数据的编解码和传输。
3. 三大交互通道详解
3.1 MethodChannel（单次异步调用）
这是最常用的方式，类似于 HTTP 的 Request-Response 模式。
-
场景：获取电量、调用相机、清理缓存、弹出原生 Toast。
-
Android 端 (Kotlin)：
Kotlin
private val CHANNEL = "com.example.app/method"
override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
super.configureFlutterEngine(flutterEngine)
MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
if (call.method == "getNativeInfo") {
val userInfo = mapOf("name" to "Gemini", "version" to "1.0")
result.success(userInfo) // 返回给 Flutter
} else {
result.notImplemented()
}
}
}
-
Flutter 端 (Dart)：
Dart
static const platform = MethodChannel('com.example.app/method');
Future<void> fetchNativeData() async {
try {
final Map result = await platform.invokeMethod('getNativeInfo');
print("来自原生的数据: ${result['name']}");
} on PlatformException catch (e) {
print("调用失败: ${e.message}");
}
}
3.2 EventChannel（持续流通信）
用于**数据流（Stream）**传输，原生端主动向 Flutter 发送连续不断的数据。
-
场景：加速度计数据、网络状态实时监听、文件下载进度更新。
-
Android 端 (Kotlin)：
Kotlin
EventChannel(flutterEngine.dartExecutor.binaryMessenger, "com.example.app/event").setStreamHandler(
object : EventChannel.StreamHandler {
override fun onListen(arguments: Any?, events: EventChannel.EventSink?) {
// 模拟持续推送
Timer().schedule(0, 1000) {
activity.runOnUiThread {
events?.success("当前秒数: ${System.currentTimeMillis() / 1000}")
}
}
}
override fun onCancel(arguments: Any?) {}
}
)
-
Flutter 端 (Dart)：
Dart
static const _eventChannel = EventChannel('com.example.app/event');
void _listenNativeStream() {
_eventChannel.receiveBroadcastStream().listen((data) {
print("接收到流更新: $data");
});
}
3.3 BasicMessageChannel（双向消息）
支持自定义编解码器，适合传递大字符串、JSON 或字节数组。
4. PlatformView：原生 UI 嵌入
如果你想在 Flutter 的组件树中直接插入一个原生的 Android View（如百度地图、原生播放器），就需要用到 PlatformView。
Android 侧：
-
实现 PlatformView 接口。
-
实现 PlatformViewFactory 类。
-
在 MainActivity 中注册 Factory：
flutterEngine.platformViewsController.registry.registerViewFactory("my-native-view", MyViewFactory())
Flutter 侧：
Dart
AndroidView(
viewType: 'my-native-view',
creationParams: {"text": "Hello Flutter!"},
creationParamsCodec: const StandardMessageCodec(),
)
5. 总结：交互方案对比
| 方案 | 通信模式 | 适用场景 |
| MethodChannel | 异步请求/响应 | 绝大多数原生 API 调用 |
| EventChannel | 单向持续流 | 传感器、进度、系统状态监听 |
| BasicMessageChannel | 灵活双向通信 | 高频、大块数据交换 |
| PlatformView | 视图嵌入 | 原生广告、地图、视频播放器 |
6. 避坑指南
线程问题：Platform Channel 的所有操作必须在 Android 主线程（UI Thread） 中执行，如果在子线程操作，请使用 Handler(Looper.getMainLooper()).post { … }。
通道命名：建议使用 域名/业务名 的格式，避免多个插件之间命名冲突。
类型安全：Channel 默认是动态类型的。在大型项目中，强烈建议使用 Pigeon 库来生成强类型的代码，减少手写字符串带来的 Bug。
希望这篇文章能帮你理清 Flutter 与 Android 原生交互的思路！如果你有具体的业务场景问题，欢迎在评论区交流。
