Flutter 与 Android 的互通几种方式
Flutter 与 Android 的互通主要通过以下几种方式实现,每种方式适用于不同的场景:
1. 平台通道(Platform Channels)
Flutter 与原生 Android 代码通信的核心方式,支持双向调用。
类型:
- MethodChannel:双向方法调用(最常用)
- EventChannel:用于原生向 Flutter 发送事件流(如传感器数据)
- BasicMessageChannel:简单的消息传递(较少使用)
示例(MethodChannel):
// Flutter 侧(Dart)
const channel = MethodChannel('com.example/app');
Future<void> getNativeData() async {try {final String result = await channel.invokeMethod('getData');print('原生返回: $result');} on PlatformException catch (e) {print('调用失败: ${e.message}');}
}
// Android 侧(Kotlin)
class MainActivity : FlutterActivity() {override fun configureFlutterEngine(flutterEngine: FlutterEngine) {super.configureFlutterEngine(flutterEngine)MethodChannel(flutterEngine.dartExecutor.binaryMessenger, "com.example/app").setMethodCallHandler { call, result ->if (call.method == "getData") {result.success("Hello from Android!")} else {result.notImplemented()}}}
}
2. 插件(Plugins)
封装原生功能的可复用模块,社区或官方提供(如相机、定位等)。
使用步骤:
- 添加依赖(
pubspec.yaml
):dependencies:url_launcher: ^6.0.0
- 调用插件:
import 'package:url_launcher/url_launcher.dart'; Future<void> launchURL() async {if (await canLaunch('https://flutter.dev')) {await launch('https://flutter.dev');} }
自定义插件:
通过 flutter create --template=plugin
生成插件模板,自动生成平台通道代码。
3. 平台视图(Platform Views)
在 Flutter 中嵌入原生 Android 控件(如 WebView、地图)。
示例(嵌入 Android View):
// Flutter 侧
Widget build(BuildContext context) {return AndroidView(viewType: 'native_view',creationParams: {'text': 'Flutter传递的参数'},creationParamsCodec: StandardMessageCodec(),);
}
// Android 侧注册视图
class NativeViewFactory : PlatformViewFactory(StandardMessageCodec.INSTANCE) {override fun create(context: Context, id: Int, args: Any?): PlatformView {val params = args as Map<String, Any>return NativeView(context, params["text"] as String)}
}// 在 FlutterActivity 中注册
flutterEngine.platformViewsController.registry.registerViewFactory("native_view", NativeViewFactory()
)
4. 直接调用原生 Activity/Service
从 Flutter 启动 Android 原生页面或服务。
示例:
// Flutter 侧
const channel = MethodChannel('com.example/activity');
Future<void> startNativeActivity() async {await channel.invokeMethod('startVideoPlayer', {'url': 'video.mp4'});
}
// Android 侧
MethodChannel(flutterEngine.dartExecutor, "com.example/activity").setMethodCallHandler { call, result ->if (call.method == "startVideoPlayer") {val url = call.argument<String>("url")val intent = Intent(this, VideoPlayerActivity::class.java).apply {putExtra("videoUrl", url)}startActivity(intent)result.success(null)}
}
5. 数据共享
通过共享存储(如 SharedPreferences、数据库)传递数据。
示例(SharedPreferences):
// Flutter 侧
final prefs = await SharedPreferences.getInstance();
await prefs.setString('token', 'abc123');
// Android 侧读取(同一文件)
val prefs = getSharedPreferences("FlutterSharedPreferences", MODE_PRIVATE)
val token = prefs.getString("flutter.token", "") // 注意键名前缀 `flutter.`
6. FFI(Foreign Function Interface)
直接调用 C/C++ 代码(通过 dart:ffi
),适用于高性能计算或底层操作。
适用场景:
- 调用现有的 C/C++ 库。
- 需要极致性能的模块(如图像处理)。
如何选择?
场景 | 推荐方式 |
---|---|
简单方法调用 | MethodChannel |
持续事件监听(如传感器) | EventChannel |
复用社区功能(如相机) | Plugins |
嵌入复杂原生控件 | Platform Views |
启动原生页面 | 调用 Activity/Service |
共享简单数据 | SharedPreferences |
高性能原生代码交互 | FFI |
注意事项
- 线程问题:原生代码默认在 UI 线程执行,耗时操作需切换到子线程。
- 异步处理:Flutter 侧使用
Future
,原生侧需调用result.success()
或result.error()
。 - 性能:频繁跨平台通信可能影响性能,尽量批量传递数据。
通过合理选择这些方式,可以无缝结合 Flutter 的跨平台优势与 Android 的原生能力。