Android React Native多ReactInstanceManager的使用

一、什么是ReactInsanceManager

ReactInstanceManager是React Native在Android端的核心管理类,负责:

  • 创建和管理JavaScript运行环境(JS Engine, 如Hermes或JSC)
  • 管理React Native的Bridge机制,用于JavaScript和原生代码通信
  • 加载JavaScript Bundle(如index.android.bundle)
  • 维护Native组件和React组件的生命周期(Activity/Fragment之间的通信)

二、为什么需要使用多ReactInstanceManager

✅ 多个页面之间都会操作全局状态,为了避免互相影响,需要使用多实例进行隔离。

✅ 需要有独立的JS逻辑

三、如何实现多ReactInstanceManager

1. ReactRootView

kotlin 复制代码
//in MainActivity.kt
private fun initRootView1() {
    val newReactInstanceManager = ReactInstanceManager
        .builder()
        .setApplication(application)                        //绑定Application
        .setCurrentActivity(this)                           //绑定Activity
        .setBundleAssetName("index.android.bundle")         //指定JS Bundle
        .setJSMainModulePath("index")                       //指定JS入口文件
        .addPackage(MainReactPackage())                     //加载默认的RN组件
        .setUseDeveloperSupport(BuildConfig.DEBUG)          //是否开启开发者模式
        .setInitialLifecycleState(LifecycleState.RESUMED)   //设置初始生命周期
        .build()

    val rootView = ReactRootView(this)
    rootView.startReactApplication(
        newReactInstanceManager,
        "MyFirstRNDemo",
        Bundle().apply {
            putInt("pageType", 1)
        }
    )
    binding.rootView1.addView(
        rootView,
        0,
        FrameLayout.LayoutParams(FrameLayout.LayoutParams.MATCH_PARENT, FrameLayout.LayoutParams.MATCH_PARENT)
    )

    binding.destroyBt1.setOnClickListener {
        Log.d("EANAM", "initRootView1: clear host")
        newReactInstanceManager.invalidate()
    }
}

2. ReactActivity/ReactFragment

针对ReactActivity/ReactFragment我们需要创建的ReactNativeHost容器来提供独立的ReactInstanceManager实例

  • 重写ReactActivity的createReactActivityDelegate,避免使用Application中创建的ReactNativeHost对象
kotlin 复制代码
/**
 * Returns the instance of the [ReactActivityDelegate]. We use [DefaultReactActivityDelegate]
 * which allows you to enable New Architecture with a single boolean flags [fabricEnabled]
 */
override fun createReactActivityDelegate(): ReactActivityDelegate {
    return object: ReactActivityDelegate(this, this.mainComponentName) {
        override fun getReactNativeHost(): ReactNativeHost {
            return object: DefaultReactNativeHost(application) {
                override fun getPackages() = PackageList(application).packages
                override fun getUseDeveloperSupport(): Boolean = BuildConfig.DEBUG
            }
        }
    }
}
  • 重新ReactFragment的getReactNativeHost方法
kotlin 复制代码
override fun getReactNativeHost(): ReactNativeHost {
    return object: DefaultReactNativeHost(MainApplication.app) {
        override fun getPackages() = PackageList(application).packages
        override fun getUseDeveloperSupport(): Boolean = BuildConfig.DEBUG
    }
}

四、React Native实例的生命周期

正常情况下,我们在Application中会实现一个ReactNativeHost变量,这个变量持有的ReactInstanceManager会在整个应用生命周期中都存在,所以这个不需要我们去销毁。

而其他情况下(多ReactInstanceManager/ReactNativeHost),React Native没有自动销毁的机制,所以需要我们去手动调用。

kotlin 复制代码
newReactInstanceManager.invalidate()
kotlin 复制代码
reactNativeHost.clear()

五、共用的ReactInstanceManager被销毁会怎么样?

1. 调用ReactInstanceManager.invalidate()销毁

  • 已展示的视图正常展示,但是点击、触摸事件不会被处理,因为js引擎已被销毁
  • 重新触发ReactRootView.startApplication,传入同一个ReactInsatanceManager无法加载视图

2. 直接调用ReactNativeHost.clear()销毁

  • 已展示的视图正常展示,但是点击、触摸事件不会被处理,因为js引擎已被销毁
  • 重新触发使用ReactNativeHost的Activity/Fragment展示,表现正常
  • 重新触发可以展示的原因:
    • ReactNativeHost.clear会销毁并置空ReactInstanceManager
    • Activity/Fragment调用ReactNativeHost.getReactInstanceManager时会重新创建
相关推荐
青青家的小灰灰1 分钟前
深入理解 JavaScript 箭头函数:从语法糖到核心机制
前端·javascript·面试
cxxcode4 分钟前
Web Vitals 数据采集机制分析
前端
sniper7 分钟前
AI+Shopify 前端开发:实战一年后,聊聊 AI Agent 和前端的生死局
前端
南囝coding8 分钟前
OpenClaw 到底能干什么?可以看看这 60 个真实用例
前端·后端
重庆穿山甲12 分钟前
Java开发者的大模型入门:AgentScope Java组件全攻略(二)
前端·后端
我爱吃土豆111917 分钟前
从零到上架:Chrome 新标签页生产力扩展 FocusTab
前端·产品
敲代码的约德尔人18 分钟前
我在 3 个项目中踩坑后,才真正理解了 JavaScript 设计模式
前端·javascript
子淼81219 分钟前
Kali Linux 入门指南:基础操作与常用指令解析
前端
QYR市场调研27 分钟前
低密度聚乙烯市场竞争格局变化趋势
前端
学以智用33 分钟前
Vue 3 组件完全指南
前端·vue.js