Flutter如何与原生交互

在 Flutter 中，与原生（Android / iOS）交互主要通过 Platform Channel 实现。下面从原理、方式、示例几个层面说明。

一、核心机制：Platform Channel

Flutter 与原生不在同一线程、不同语言环境，通信通过 异步消息通道。

三种常用 Channel：

二、MethodChannel（最常用）

1️⃣ Flutter 端

import 'package:flutter/services.dart';

const platform = MethodChannel('com.example/app');

Future<void> getBatteryLevel() async {
  try {
    final int result = await platform.invokeMethod('getBatteryLevel');
    print('电池电量: $result%');
  } on PlatformException catch (e) {
    print("失败: ${e.message}");
  }
}

2️⃣ Android 端（Kotlin）

import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel

class MainActivity : FlutterActivity() {
    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)

        MethodChannel(
            flutterEngine.dartExecutor.binaryMessenger,
            "com.example/app"
        ).setMethodCallHandler { call, result ->
            if (call.method == "getBatteryLevel") {
                val level = 80
                result.success(level)
            } else {
                result.notImplemented()
            }
        }
    }
}

3️⃣ iOS 端（Swift）

import Flutter

class AppDelegate: FlutterAppDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {

        let controller = window?.rootViewController as! FlutterViewController
        let channel = FlutterMethodChannel(
            name: "com.example/app",
            binaryMessenger: controller.binaryMessenger
        )

        channel.setMethodCallHandler { call, result in
            if call.method == "getBatteryLevel" {
                result(85)
            } else {
                result(FlutterMethodNotImplemented)
            }
        }

        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}

三、原生调用 Flutter（反向通信）

platform.setMethodCallHandler((call) async {
  if (call.method == "fromNative") {
    print(call.arguments);
  }
});

原生调用：

channel.invokeMethod("fromNative", "Hello from Android")

四、EventChannel（持续事件）

适合：

• 定位
• 蓝牙
• 传感器

Flutter

EventChannel('com.example/events')
    .receiveBroadcastStream()
    .listen((event) {
  print(event);
});

五、推荐方案（更现代）

✅ Pigeon（官方代码生成）

• 类型安全
• 少写样板代码
• 支持 Method / Event

dev_dependencies:
  pigeon: ^x.x.x

六、常见使用场景

• 调用系统 API（电量、蓝牙、通知）
• 使用原生 SDK（微信、支付宝）
• 性能敏感模块（音视频、图像处理）
• 已有原生业务复用

如果你告诉我：

• ✅ Android / iOS
• ✅ 具体功能（如蓝牙、定位、支付）

我可以直接给你完整可运行示例。