Flutter plugin开发小知识之:ActivityAware 详解

本文首发于公众号:移动开发那些事Flutter plugin开发小知识之:ActivityAware 详解

1 背景

Flutter 插件开发里,如果插件需要和 Android Activity 进行交互,或者要感知 Activity 的生命周期变化,那就得使用 ActivityAware接口啦。 ActivityAware允许插件感知宿主Android应用的Activity生命周期变化,从而能够根据Activity的状态调整插件的行为。本文将详细介绍ActivityAware的相关知识。

2 ActivityAware概述

plugin实现了这个接口后,Flutter引擎会在插件被添加到宿主应用时调用相应的方法,使插件能够获取当前Activity的引用,并感知Activity的生命周期变化。

2.1 使用场景

  • 获取 Activity 上下文: 用于一些与Activity相关的操作,如权限请求等;
  • 监听 Activity 生命周期: 需要监听其生命周期来实现自身plugin的逻辑的处理,如前后台切换的处理;
  • 处理 onActivityResult: 如处理相机、文件选择等返回结果;

2.2 核心方法

  • onAttachedToActivity(ActivityPluginBinding binding)

当插件和Activity 绑定时,会调用这个方法。通过ActivityPluginBinding,插件可以获取 Activity 的引用,还能注册 Activity结果回调以及请求权限的回调。

  • onDetachedFromActivityForConfigChanges()

Activity 因为配置变更(例如屏幕旋转)暂时和插件分离时,会触发该方法。此时,插件应当释放和 Activity 相关的资源。

  • onReattachedToActivityForConfigChanges(ActivityPluginBinding binding)

Activity 配置变更完成并重新和插件绑定时,会调用这个方法。插件可以借此重新初始化和 Activity 相关的资源。

  • onDetachedFromActivity()

当插件和 Activity 的绑定永久解除时,会执行该方法。插件需要在此释放所有和 Activity 相关的资源。

3 示例

下面以一个简单的 Flutter 插件为例,展示实现 ActivityAware 接口的具体步骤:

kotlin 复制代码
class MyPlugin : FlutterPlugin, ActivityAware {
    private var flutterPluginBinding: FlutterPlugin.FlutterPluginBinding? = null
    /// 这里其实也可以用弱引用的方式来做
    private var activity: Activity? = null

    override fun onAttachedToEngine(binding: FlutterPlugin.FlutterPluginBinding) {
        this.flutterPluginBinding = binding
        // 初始化插件
    }

    // ActivityAware的几个方法 start
    override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) {
        this.flutterPluginBinding = null
        // 清理资源
    }

    override fun onAttachedToActivity(binding: ActivityPluginBinding) {
        this.activity = binding.activity
        // 注册Activity生命周期回调
        binding.addOnActivityDestroyedListener { onActivityDestroyed(it) }
    }

    override fun onDetachedFromActivityForConfigChanges() {
        this.activity = null
        // 释放和Activity相关的资源
    }

    override fun onReattachedToActivityForConfigChanges(binding: ActivityPluginBinding) {
        this.activity = binding.activity
        // 重新注册Activity生命周期回调
        binding.addOnActivityDestroyedListener { onActivityDestroyed(it) }
    }

    override fun onDetachedFromActivity() {
        this.activity = null
    }

    // ActivityAware的几个方法 end

    private fun onActivityDestroyed(activity: Activity) {
        // Activity被销毁时的处理
    }


    // 示例方法:从Flutter调用启动新的Activity
    fun startNewActivity() {
        activity?.let {
            val intent = Intent(it, DemoActivity::class.java)
            it.startActivity(intent)
        } ?: run {
            // 处理没有Activity引用的情况
            Log.e("MyPlugin", "Activity reference is null")
        }
    }
}

4 总结

ActivityAwareFlutter插件开发中连接插件与Android Activity的关键接口,正确使用ActivityAware可以大大增强插件的功能性和稳定性,特别是在需要与Android原生组件交互的场景中

5 参考

相关推荐
手机不死我是天子14 小时前
《Android 核心组件深度系列 · 第 2 篇 Service》
android
前行的小黑炭14 小时前
Compose页面切换的几种方式:Navigation、NavigationBar+HorizontalPager,会导致LaunchedEffect执行?
android·kotlin·app
前行的小黑炭15 小时前
Android :Comnpose各种副作用的使用
android·kotlin·app
BD_Marathon1 天前
【MySQL】函数
android·数据库·mysql
西西学代码1 天前
安卓开发---耳机的按键设置的UI实例
android·ui
maki0771 天前
虚幻版Pico大空间VR入门教程 05 —— 原点坐标和项目优化技巧整理
android·游戏引擎·vr·虚幻·pico·htc vive·大空间
千里马学框架1 天前
音频焦点学习之AudioFocusRequest.Builder类剖析
android·面试·智能手机·车载系统·音视频·安卓framework开发·audio
fundroid2 天前
掌握 Compose 性能优化三步法
android·android jetpack
TeleostNaCl2 天前
如何在 IDEA 中使用 Proguard 自动混淆 Gradle 编译的Java 项目
android·java·经验分享·kotlin·gradle·intellij-idea
旷野说2 天前
Android Studio Narwhal 3 特性
android·ide·android studio