Flutter插件开发：手把手教你编写自定义插件

原创于 2025-07-22 10:02:36 发布 · 472 阅读

CC 4.0 BY-SA版权

文章标签：

# Flutter插件开发：手把手教你编写自定义插件

> 关键词：Flutter插件、Platform Channel、跨平台开发、Dart与原生通信、MethodChannel、EventChannel、插件发布  
> 摘要：本文将通过一个电池电量检测插件的完整开发案例，带你掌握Flutter插件开发的核心原理。从Platform Channel工作机制到多平台代码实现，从Dart接口封装到插件发布全流程，用生活化比喻+实战代码演示插件开发的完整知识体系。

## 背景介绍
### 目的和范围
帮助开发者掌握为Flutter应用扩展原生功能的插件开发技能，涵盖Android/iOS双平台实现与Dart层通信。

### 预期读者
- 具备Flutter基础知识的开发者
- 需要与硬件/原生功能交互的跨平台开发者
- 希望发布Flutter插件的开源贡献者

### 术语表
#### 核心术语定义
- **Platform Channel**：Flutter与原生平台通信的桥梁
- **MethodChannel**：用于方法调用的双向通信管道
- **EventChannel**：用于原生向Flutter发送事件流的单向通道

#### 相关概念解释
![](https://files.mdnice.com/user/32904/7f4c6a1b-8a07-4d52-9ed0-3bb2c9d4c3cc.png)

## 核心概念与联系
### 故事引入
想象你的Flutter应用是个国际外交官，需要与Android和iOS两个国家进行交流。插件就像翻译官，把Dart语言翻译成Java/Kotlin（Android）和Swift/Objective-C（iOS），让外交官能顺利获取电池电量、调用摄像头等"国家机密"。

### 核心概念解释
#### Platform Channel：跨语言电话会议
就像跨国公司的视频会议系统，Dart、Android、iOS三方通过特定"频道"（Channel）进行沟通。每个频道有专属的频道名保证信息不串线。

#### MethodChannel：问答式对话
当Flutter需要主动询问电量时，就像拨通电话问："当前电量多少？"，等待原生端回复具体数值。整个过程类似：

```mermaid
graph TD
  A[Flutter调用方法] --> B{MethodChannel}
  B --> C[Android处理]
  B --> D[iOS处理]
  C --> E[返回结果]
  D --> E
  E --> A

EventChannel：实时广播系统

当需要持续监听电量变化时，类似开启电视直播。原生端作为电视台，Flutter端打开电视（监听）就能持续接收数据流。

核心概念关系

Platform Channel是通信基础，MethodChannel和EventChannel是两种通信模式。就像公司既有即时通讯（Method）也有邮件列表（Event）两种沟通方式。

核心算法原理

Flutter与原生通信采用二进制序列化协议，通过StandardMethodCodec自动处理数据转换：

// Dart调用示例
final batteryLevel = await methodChannel.invokeMethod('getBatteryLevel');

// Android端实现
override fun onMethodCall(call: MethodCall, result: Result) {
  when (call.method) {
    "getBatteryLevel" -> {
      val level = getBatteryLevel()
      result.success(level)
    }
    else -> result.notImplemented()
  }
}

// iOS端实现
public func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
  switch call.method {
  case "getBatteryLevel":
    let level = getBatteryLevel()
    result(level)
  default:
    result(FlutterMethodNotImplemented)
  }
}

项目实战：电池电量检测插件

开发环境搭建

创建插件项目：

flutter create --template=plugin battery_plugin

项目结构说明：

battery_plugin/
├── lib/           # Dart接口
├── android/       # Android实现
├── ios/           # iOS实现
└── example/       # 示例应用

代码实现

Dart层接口定义：

class BatteryPlugin {
  static const MethodChannel _channel = 
      const MethodChannel('battery_plugin');

  static Future<int> get batteryLevel async {
    final version = await _channel.invokeMethod('getBatteryLevel');
    return version;
  }
}

Android实现：

class BatteryPlugin : FlutterPlugin, MethodCallHandler {
  override fun onAttachedToEngine(flutterPluginBinding: FlutterPlugin.FlutterPluginBinding) {
    val channel = MethodChannel(flutterPluginBinding.binaryMessenger, "battery_plugin")
    channel.setMethodCallHandler(this)
  }

  private fun getBatteryLevel(context: Context): Int {
    val batteryIntent = context.registerReceiver(null, 
        IntentFilter(Intent.ACTION_BATTERY_CHANGED))!!
    return batteryIntent.getIntExtra(BatteryManager.EXTRA_LEVEL, -1)
  }

  override fun onMethodCall(call: MethodCall, result: Result) {
    when (call.method) {
      "getBatteryLevel" -> {
        val level = getBatteryLevel(context)
        result.success(level)
      }
      else -> result.notImplemented()
    }
  }
}

iOS实现：

@objc public class BatteryPlugin: NSObject, FlutterPlugin {
  public static func register(with registrar: FlutterPluginRegistrar) {
    let channel = FlutterMethodChannel(name: "battery_plugin", 
        binaryMessenger: registrar.messenger())
    let instance = BatteryPlugin()
    registrar.addMethodCallDelegate(instance, channel: channel)
  }

  private func getBatteryLevel() -> Int {
    let device = UIDevice.current
    device.isBatteryMonitoringEnabled = true
    return Int(device.batteryLevel * 100)
  }

  public func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
    switch call.method {
    case "getBatteryLevel":
      result(getBatteryLevel())
    default:
      result(FlutterMethodNotImplemented)
    }
  }
}