Flutter 与 Android 的互通几种方式

发布于:2025-07-11 ⋅ 阅读:(14) ⋅ 点赞:(0)

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)

封装原生功能的可复用模块,社区或官方提供(如相机、定位等)。

使用步骤
  1. 添加依赖pubspec.yaml):
    dependencies:
      url_launcher: ^6.0.0
    
  2. 调用插件
    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

注意事项

  1. 线程问题:原生代码默认在 UI 线程执行,耗时操作需切换到子线程。
  2. 异步处理:Flutter 侧使用 Future,原生侧需调用 result.success()result.error()
  3. 性能:频繁跨平台通信可能影响性能,尽量批量传递数据。

通过合理选择这些方式,可以无缝结合 Flutter 的跨平台优势与 Android 的原生能力。


网站公告

今日签到

点亮在社区的每一天
去签到