Flutter 插件开发：Platform Channel 与原生调用

1. Platform Channel 核心概念

Platform Channel 是 Flutter 与原生平台（Android/iOS）通信的桥梁，通过异步消息传递实现双向交互。核心组件：

• MethodChannel：最常用，用于方法调用和结果返回
• EventChannel：处理原生到 Flutter 的持续数据流（如传感器数据）
• BasicMessageChannel：基础消息传递（支持自定义编解码）

2. 通信流程

graph LR
A[Flutter Dart] -->|请求| B(MethodChannel)
B --> C[Android/Kotlin]
B --> D[iOS/Swift]
C -->|响应| B
D -->|响应| B
B -->|结果| A

3. 开发步骤

(1) Flutter 端（Dart）

// 创建 MethodChannel
const _channel = MethodChannel('com.example/native');

// 调用原生方法
Future<String> getPlatformVersion() async {
  try {
    final String result = await _channel.invokeMethod('getPlatformVersion');
    return result;
  } on PlatformException catch (e) {
    return "Failed: '${e.message}'";
  }
}

(2) Android 端（Kotlin）

class MainActivity : FlutterActivity() {
  private val CHANNEL = "com.example/native"

  override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
    MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
      when (call.method) {
        "getPlatformVersion" -> {
          result.success("Android ${Build.VERSION.RELEASE}")
        }
        else -> result.notImplemented()
      }
    }
  }
}

(3) iOS 端（Swift）

@UIApplicationMain
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/native",
                                      binaryMessenger: controller.binaryMessenger)
    
    channel.setMethodCallHandler { (call: FlutterMethodCall, result: @escaping FlutterResult) in
      if call.method == "getPlatformVersion" {
        result("iOS \(UIDevice.current.systemVersion)")
      } else {
        result(FlutterMethodNotImplemented)
      }
    }
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}

4. **数据类型映射

5. 最佳实践

1. 通道命名：使用反向域名格式（如 com.example.service）
2. 错误处理：

   _channel.invokeMethod('method').catchError((error) {
     // 处理 PlatformException
   });
   

3. 线程安全：
   • Android：确保在主线程更新 UI
   • iOS：GCD 调度到主队列
4. 性能优化：
   • 减少跨平台调用频率
   • 批量传输大数据时使用 ByteData
   • 避免在热重载路径中注册通道

6. 调试技巧

• 检查通道名称一致性
• 使用 print 在两端输出日志
• Flutter 端捕获 PlatformException：

  try {
    await _channel.invokeMethod('method');
  } on PlatformException catch (e) {
    debugPrint("Error code: ${e.code}, message: ${e.message}");
  }
  

7. 高级应用场景

• EventChannel 实现：持续获取传感器数据

  // Dart 端
  _eventChannel.receiveBroadcastStream().listen((data) {
    print("Received: $data");
  });
  

• 混合编解码：传输自定义对象

  // Android 端
  val gson = Gson()
  result.success(gson.toJson(customObject))
  

关键点：Platform Channel 本质是异步消息队列，所有操作非阻塞。开发时需注意平台差异，建议使用 flutter_plugin_tools 管理多平台代码。