Flutter 插件 Federated plugins

最新推荐文章于 2026-04-12 15:32:44 发布

原创最新推荐文章于 2026-04-12 15:32:44 发布 · 530 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#flutter

Flutter 专栏收录该内容

5 篇文章

订阅专栏

本文介绍了Flutter的联邦化插件（Federated plugins）概念，旨在将不同平台的代码分离。Federated plugins包含平台接口包、平台实现包和面向应用的包。文中提供了一个简单的演示，通过接口中的静态成员`instance`来获取平台实现，并讨论了官方与个人实践的不同做法。此外，还推荐了相关阅读资料以深入理解。

2020-05-15 12:19:39
Federated plugins

Federated plugins

插件 2.0 还提出了 federated plugins 的概念。
官网的大致意思是：
在这之前，一个插件中包含了 Dart 代码，Android 平台代码和 iOS 平台代码，他们都在一个包中。
federated plugins 的目的是把他们分离成独立的包。

需要3种类型的包：

platform interface package
各平台需要提供的功能，都以接口的形式声明在了这个包中。
platform package(s)
特定平台实现接口的包。可以有多个，比如一个用于 Web ，一个用于 Mac OS 。
app-facing package
是给使用插件的人用的。插件为 app 提供的各种功能在这个包中，插件使用者调用这个包中的方法。
接口为这个包提供一个平台的实现，这个包调用实现中的方法。

使用一个插件，直接用到的就是 app-facing package 。

官网给出了一个 Medium 上的文章 How To Write a Flutter Web Plugin, Part 2。
但是不太容易看懂，可以先看另一篇。Modern Flutter Plugin Development 。

文章中反复强调实现接口的时候要用 extends ，不要用 implements 。

虽然官方提出了这个东西，但是官方插件中的安卓和 iOS 代码还是写在老地方。
因为 federated plugins 的出现，主要是方便为安卓和 iOS 之外的平台添加支持，
比如 Web 和 Mac OS 。
不过挺多插件已经把接口分离出来了。

我的演示

如果把插件示例改成 federated plugins 的话。
可以先简单点。直接在同一个位置放3个文件就好了。

/// 文件 platform_interface.dart
/// 相当于 platform interface package

import 'platform_channel.dart';

abstract class DemoInterface {

  static DemoInterface instance = DemoChannel();

  Future<String> get platformVersion {
    throw UnimplementedError('platformVersion has not been implemented.');
  }
}

/// 文件 platform_channel.dart
/// 相当于 platform package

import 'package:flutter/services.dart';

import 'platform_interface.dart';

const MethodChannel _channel = const MethodChannel('platform_channel');

class DemoChannel extends DemoInterface {

  static void register() {
    DemoInterface.instance = DemoChannel();
  }

  @override
  Future<String> get platformVersion async {
    final String version = await _channel.invokeMethod('getPlatformVersion');
    return version;
  }
}

/// 文件 federated_plugin_demo.dart
/// 相当于 app-facing package

import 'dart:async';

import 'platform_interface.dart';

class DemoPlugin {

  static Future<String> get platformVersion async {
    final String version = await DemoInterface.instance.platformVersion;
    return version;
  }
}

/// 在 Flutter app 中的使用
import 'dart:async';

import 'federated_plugin_demo.dart';

Future<void> foo() async {
  String platformVersion = await DemoPlugin.platformVersion;
}

platform package 实现了接口。
app-facing package 通过接口类的静态成员 instance 得到接口类的实现，
然后就可以调用接口中的方法。