Flutter插件(Plugin)开发 - Android视角，写给即将正在找工作的Android攻城狮

最新推荐文章于 2024-04-17 21:56:04 发布

努力马斯克

最新推荐文章于 2024-04-17 21:56:04 发布

阅读量884

点赞数 15

分类专栏： 2024年程序员学习文章标签： flutter android

本文链接：https://blog.csdn.net/m0_60452293/article/details/136970408

版权

2024年程序员学习专栏收录该内容

332 篇文章 1 订阅

订阅专栏

PluginRegistry.Registrar addNewIntentListener(PluginRegistry.NewIntentListener var1);
//注册UserLeaveHint回调
PluginRegistry.Registrar addUserLeaveHintListener(PluginRegistry.UserLeaveHintListener var1);
//注册View销毁回调
PluginRegistry.Registrar addViewDestroyListener(PluginRegistry.ViewDestroyListener var1);
}

。。。简直就是个宝库啊。里面的中文注释我是照官方英文文档翻译的，有些方法的用途也不太明确，有待大家的发掘。本例中目前只需要两个方法，调用activity()就拿到Host App的Activity。addActivityResultListener设置处理返回结果的回调。代码如下:

// 实现 PluginRegistry.ActivityResultListener
public class FlutterMusicPlugin implements MethodCallHandler, PluginRegistry.ActivityResultListener {
…
private Activity mActivity;
// 加个构造函数，入参是Activity
private FlutterMusicPlugin(Activity activity) {
// 存起来
mActivity = activity;
}

public static void registerWith(Registrar registrar) {
//传入Activity
final FlutterMusicPlugin plugin = new FlutterMusicPlugin(registrar.activity());
…
// 注册ActivityResult回调
registrar.addActivityResultListener(plugin);
}

@Override
public void onMethodCall(MethodCall call, Result result) {
switch (call.method) {
…
case “open”:
Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
intent.addCategory(Intent.CATEGORY_OPENABLE);
intent.setType(“audio/*”);
mActivity.startActivityForResult(intent, REQUEST_CODE_OPEN);
break;
…
}
}

@Override
public boolean onActivityResult(int requestCode, int resultCode, Intent data) {
if (requestCode == REQUEST_CODE_OPEN && resultCode == RESULT_OK) {
Uri uri = data.getData();
if (uri != null) {
// 拿到音频文件uri,开始播放。
play(uri);
} else {
mStateSink.error(“ERROR”, “invalid media file”, null);
}
return true;
}
return false;
}
}

我们改造一下FlutterMusicPlugin, 增加以Activity为入参的构造函数，在静态函数registerWith里实例化的时候传入Host app的Activity。同时注册自身来处理onActivityResult回调。在onMethodCall方法内"open"下启动第三方选择音频文件的页面。当用户选好了某首歌返回的时候，插件这边就会拿到音频文件uri，并开始播放。

至此，Native端的逻辑就完成了，我们再来看看插件的Flutter端怎么做。

插件Flutter端

IDE在lib目录下会帮你自动生成flutter_music_plugin.dart文件，这个就是插件的Flutter代码所在了，内容比较简单，就是对我们定义好的Platform channels的包装。直接上代码：

typedef void EventHandler(Object event);

class FlutterMusicPlugin {
static const MethodChannel _channel = const MethodChannel(‘flutter_music_plugin’);
static const EventChannel _status_channel = const EventChannel(‘flutter_music_plugin.event.status’);
static const EventChannel _position_channel = const EventChannel(‘flutter_music_plugin.event.position’);

static Future open() async {
await _channel.invokeMethod(‘open’);
}

static Future pause() async {
await _channel.invokeMethod(‘pause’);
}

static Future start() async {
await _channel.invokeMethod(‘start’);
}

static Future getDuration() async {
int duration = await _channel.invokeMethod(‘getDuration’);
return Duration(milliseconds: duration);
}

static listenStatus(EventHandler onEvent, EventHandler onError) {
_status_channel.receiveBroadcastStream().listen(onEvent, onError: onError);
}

static listenPosition(EventHandler onEvent, EventHandler onError) {
_position_channel.receiveBroadcastStream().listen(onEvent, onError: onError);
}
}

插件Example App

除了自身的逻辑之外，一个插件还要有示例应用来演示其API怎么使用，同时，示例应用也是我们开发，调试，验证插件的必备工具。本例中的示例可参考example目录下的main.dart文件。使用插件API的主要逻辑都在State中。简要代码如下

@override
void initState() {
super.initState();
// 在这里注册EventChannles，参数传入响应的回调
FlutterMusicPlugin.listenStatus(_onPlayerStatus, _onPlayerStatusError);
FlutterMusicPlugin.listenPosition(_onPosition, _onPlayerStatusError);
}
…
// 根据播放状态调用pause或start
void _playPause() {
switch (_status) {
case “started”:
FlutterMusicPlugin.pause();
break;
case “paused”:
case “completed”:
FlutterMusicPlugin.start();
break;
}
}
// 打开媒体文件
void _open() {
FlutterMusicPlugin.open();
}
// MediaPlayer出错事件处理
void _onPlayerStatusError(Object event) {
print(event);
}
// MediaPlayer状态改变事件处理
void _onPlayerStatus(Object event) {
setState(() {
_status = event;
});
if (_status == “started”) {
_getDuration();
}
}
// 获取音频时长
void _getDuration() async {
Duration duration = await FlutterMusicPlugin.getDuration();
setState(() {
_duration = duration;
});
}
// 播放进度事件处理
void _onPosition(Object event) {
Duration position = Duration(milliseconds: event);
setState(() {
_position = position;
});
}

发布

当你的插件开发测试完成以后，你就可以把你的插件发布出去了。发布之前，先检查pubspec.yaml, README.md和CHANGELOG.md这几个文件的内容是否完整正确。然后运行下面这个命令检查插件是否可以发布。

$ flutter packages pub publish --dry-run

如果有问题存在的话，会在终端输出相关信息，你需要据此做出修改直到返回成功。具体遇到的问题可以参考官方文档

最后去掉--dry-run以后再运行以上命令。

$ flutter packages pub publish

恭喜你，你的插件终于发布出去了。

插件注册

从前文开发插件的过程中我们知道了在插件Android代码里有一个静态函数registerWith，这个函数可以把插件注册到Host App。那么问题来了，插件是什么时候注册的呢？这个静态函数是被谁调用的呢？答案就在example app的MainActivity里：

public class MainActivity extends FlutterActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 插件在这里注册
GeneratedPluginRegistrant.registerWith(this);
}
}

在onCreate函数里，有这么一行代码GeneratedPluginRegistrant.registerWith(this)。插件就是在这里注册的。再看看GeneratedPluginRegistrant的内容就明白了：

public final class GeneratedPluginRegistrant {

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级安卓工程师，想要提升技能，往往是自己摸索成长，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年最新Android移动开发全套学习资料》送给大家，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。