Flutter与Android互通的常用方式实现与适用场景详解

心理援助中心 · 發表於 2025-7-11 10:06:58

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 的原生能力。

到此这篇关于Flutter与Android互通的常用方式实现与适用场景详解的文章就介绍到这了,更多相关Flutter与Android互通内容请搜索琼殿技术社区以前的文章或继续浏览下面的相关文章希望大家以后多多支持琼殿技术社区！

您可能感兴趣的文章:

Flutter TV Android端开发技巧详细教程
Android开发组件flutter的20个常用技巧示例总结
Android开发中Flutter组件实用技巧
Android集成Flutter
Flutter 和 Android 互相传递数据的实现

[教程] Flutter与Android互通的常用方式实现与适用场景详解

目录