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 参考

相关推荐
雨白1 小时前
Drawable 与 Bitmap 的区别、互转与自定义
android
程序员江同学1 小时前
Kotlin 技术月报 | 2025 年 8 月
android·kotlin
nju永远得不到的男人2 小时前
关于virtual camera
android
雨白4 小时前
Android 自定义 View:属性动画和硬件加速
android
hellokai5 小时前
React Native新架构源码分析
android·前端·react native
真西西5 小时前
Koin:Kotlin轻量级依赖注入框架
android·kotlin
CYRUS_STUDIO8 小时前
手把手教你改造 AAR:解包、注入逻辑、重打包,一条龙玩转第三方 SDK!
android·逆向
CYRUS_STUDIO8 小时前
Android 源码如何导入 Android Studio?踩坑与解决方案详解
android·android studio·源码阅读
前端赵哈哈9 小时前
初学者入门:Android 实现 Tab 点击切换(TabLayout + ViewPager2)
android·java·android studio
一条上岸小咸鱼13 小时前
Kotlin 控制流(二):返回和跳转
android·kotlin