ReactNative 源码分析1——HybridData 机制深度分析-北京尧图网络

对于想学习Agent开发的朋友可以关注我的新项目HelloAgentR工程手记1/100天——项目工作流搭建一、HybridData 是什么HybridData来自 Facebook 的fbjni库com.facebook.jni.HybridData它是一个将 C 对象指针封装在 Java 对象中的桥梁类。本质上是 Java 层持有 C 层对象的句柄实现了 Java 和 C 之间一对一的对象绑定。二、内存管理流程┌─────────────────────────────────────────────────┐ │ Java 层 │ │ ┌──────────────────────────────┐ │ │ │ HermesExecutor │ │ │ │ mHybridData ──────────────────┐ │ │ └──────────────────────────────┘ │ │ │ ▼ │ │ ┌──────────────────────────────┐ │ │ │ HybridData (fbjni) │ │ │ │ 内部持有 C 指针 (long) │ │ │ └──────────────────────────────┘ │ └─────────────────────────────────────────────────┘ │ JNI ▼ ┌─────────────────────────────────────────────────┐ │ C 层 │ │ ┌──────────────────────────────┐ │ │ │ HermesExecutorHolder (C) │ │ │ │ │ │ │ │ │ │ │ └──────────────────────────────┘ │ └─────────────────────────────────────────────────┘二、核心工作原理public class HermesExecutor extends JavaScriptExecutor { private static String mode_ ; static { loadLibrary(); } public static void loadLibrary() throws UnsatisfiedLinkError { if (mode_ null) { // libhermes must be loaded explicitly to invoke its JNI_OnLoad. SoLoader.loadLibrary( hermes ); SoLoader.loadLibrary( hermes_executor ); // libhermes_executor is built differently for Debug Release so we load the proper mode. mode_ ReactBuildConfig.DEBUG ? Debug : Release ; } } HermesExecutor(Nullable RuntimeConfig config, boolean enableDebugger, String debuggerName) { super( config null ? initHybridDefaultConfig(enableDebugger, debuggerName) : initHybrid(enableDebugger, debuggerName, config.getHeapSizeMB())); } Override public String getName() { return HermesExecutor mode_ ; } private static native HybridData initHybridDefaultConfig( boolean enableDebugger, String debuggerName); private static native HybridData initHybrid( boolean enableDebugger, String debuggerName, long heapSizeMB); }HermesExecutor继承JavaScriptExecutorJavaScriptExecutor中定义了一个mHybridData字段private final HybridData mHybridData;HermesExecutor构造函数调用initHybridDefaultConfig或initHybrid返回一个HybridData对象initHybridDefaultConfig和initHybrid都是native方法在OnLoad.cpp中注册了这两个方法并且这两个方法都是HermesExecutorHolder类中static void registerNatives() { registerHybrid( {makeNativeMethod( initHybrid , HermesExecutorHolder::initHybrid), makeNativeMethod( initHybridDefaultConfig , HermesExecutorHolder::initHybridDefaultConfig)}); }initHybrid中会创建HermesExecutorFactory对象然后调用makeCxxInstance它是实现了 Java 和 C 之间一对一的对象绑定的关键static jni::local_refjhybriddata initHybrid( jni::alias_refjclass, bool enableDebugger, std::string debuggerName, jlong heapSizeMB) { JReactMarker::setLogPerfMarkerIfNeeded(); auto runtimeConfig makeRuntimeConfig(heapSizeMB); std::call_once(flag, []() { facebook::hermes::HermesRuntime::setFatalHandler(hermesFatalHandler); }); auto factory std::make_uniqueHermesExecutorFactory( installBindings, JSIExecutor::defaultTimeoutInvoker, runtimeConfig); factory-setEnableDebugger(enableDebugger); if (!debuggerName.empty()) { factory-setDebuggerName(debuggerName); } return makeCxxInstance(std::move(factory)); }makeCxxInstance中会创建T对象在这个案例中T为C层的HermesExecutorHolderOnLoad.cppstatic local_refdetail::HybridData makeCxxInstance(Args... args) { return makeHybridData( std::unique_ptrT(new T(std::forwardArgs(args)...))); }makeHybridData中创建了一个HybridData对象并返回到Java层static local_refdetail::HybridData makeHybridData( std::unique_ptrT cxxPart) { auto hybridData detail::HybridData::create(); setNativePointer(hybridData, std::move(cxxPart)); return hybridData; }setNativePointer中t是HybridData对象new_value是HermesExecutorHolder对象void setNativePointer( basic_strong_refT, Alloc t, std::unique_ptrdetail::BaseHybridClass new_value) { getHolder(*t)-setNativePointer(std::move(new_value)); }看完getHolder就明白了它是取出HybridData对象中的mDestructor字段local_refHybridDestructor::javaobject getHolder(const T* t) { static auto holderField getDestructorField(t-getClass()); return t-getFieldValue(holderField); } inline JFieldHybridDestructor::javaobject getDestructorField( const local_refJClass c) { return c-template getFieldHybridDestructor::javaobject( mDestructor ); }setNativePointer最终会将mDestructor.mNativePointer指向HermesExecutorHolder对象getHolder(*t)-setNativePointer(std::move(new_value)); 变成 HybridDestructor-setNativePointer(std::move(new_value)); //fbjni-0.7.0/prefab/modules/fbjni/include/fbjni/fbjni.cpp:227-237 void HybridDestructor::setNativePointer( std::unique_ptrdetail::BaseHybridClass new_value) { static auto pointerField javaClassStatic()-getFieldjlong(mNativePointer); auto old_value std::unique_ptrdetail::BaseHybridClass( reinterpret_castdetail::BaseHybridClass*(getFieldValue(pointerField))); if (new_value old_value) { FBJNI_LOGF(Attempt to set C native pointer twice); } setFieldValue(pointerField, reinterpret_castjlong(new_value.release())); }这就是“Java 对象 - native 指针 - C 实例”的回路。HermesExecutor (Java对象) -HybridData-mDestructor.mNativePointer(指针)-HermesExecutorHolder(C对象)四、在 RN 中的应用场景HybridData 在 React Native 中无处不在覆盖了几乎所有核心子系统子系统Java 类C 对应作用旧架构 BridgeCatalystInstanceImplCatalystInstanceImpl.cpp → InstanceJS 桥的核心实例新架构 BridgelessReactInstanceJReactInstance.cpp → ReactInstance新架构的运行时实例JS 引擎HermesExecutor / JSCExecutor对应的 C executorJS 执行引擎JS RuntimeHermesInstance / JSCInstanceC runtime factory创建和管理 JS 运行时数据类型WritableNativeMap / WritableNativeArrayC dynamic 对象JS 与 Java 间的数据传递TurboModuleTurboModuleManagerC TurboModule 管理新架构的模块系统Fabric 渲染ComponentFactoryC 组件注册表新架构的渲染系统运行时工具RuntimeExecutor / RuntimeSchedulerC executor/schedulerJS 任务调度

ReactNative 源码分析1——HybridData 机制深度分析

相关推荐

【Android视频监控系统技术总结】

用云手机做账号矩阵，平台合规风险到底怎么管？

YOLOv8 小样本涨点实战｜141 张手钳单类别 VOC/YOLO 数据集训练调优，工业五金工件实时检测落地全流程

更多资讯

微信小程序全栈项目实战：登录态、手机号授权与生产部署

操作系统四块知识一套账：状态迁移边界与自检框架

计算机网络入门：从DNS解析、三次握手到HTTP缓存

二维图像压缩感知重构MATLAB实战：OMP、CoSaMP与IRLS算法实现与调优

雷达信号分选源码实战：从PDW流到深度学习模型落地

TSCAPP.zip：基于Linux RT内核的工业实时调度镜像

今日更新

防幻觉智能体架构：电源硬件设计中的大模型编排与工具化实践

OpenGL面试核心考点：渲染管线、矩阵变换与性能排查全解析

全国计算机二级C语言真题PDF高效刷题指南

本周精选

防幻觉智能体架构：电源硬件设计中的大模型编排与工具化实践

OpenGL面试核心考点：渲染管线、矩阵变换与性能排查全解析

全国计算机二级C语言真题PDF高效刷题指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？