React Native Android 通信原理
mikyxiang
8年前
<p>React Native (Android)内置了一个用于解析JavaScript(以下简称JS)脚本的框架,方便把Java类暴漏给JS调用,具体的使用方法参见,这篇文章就用来研究一下Java和JS的通信原理,JS是如何调用Java的。</p> <h2>总体结构</h2> <p>当初始化阶段,Java端会把所有要暴漏的Java类的信息封装成Config传给JS,然后根据Config生成对应Java类的Javascript镜像对象,以及要暴漏的方法,在JS中调用这个镜像对象的方法就会被转发到对应的Java对象上,如下所示 <img src="https://simg.open-open.com/show/453e98d5f1a4ce4f56de229e913bc91a.png"></p> <p>JS的代码总要被解析执行,那么React是在哪里执行JS的呢?React并没有通过webview去执行JS代码,它是通过Jni调用c++代码通过Javascriptcore来执行JS的,首先来看看生成so依赖的的文件,代码在react-native/ReactAndroid/src/main/jni目录下。 <em>(用NDK编译在Android上运行的c/c++代码,关于NDK请自行google)</em> <img src="https://simg.open-open.com/show/985320caf975a6b7e4837acb9c920cdd.png"> 其中OnLoad.cpp很关键,里面通过Jni映射了本地的方法到Java中,是Java和C++之间的桥梁。在Java中主要通过ReactBridge.java来调用C++,NativeModulesReactCallback类是C++调用Java的桥梁。</p> <p>例如以下代码,截取自OnLoad.cpp的JNI_OnLoad方法 <em>(这个方法会在Java载入so文件的时候由Jni首先调用)</em></p> <pre> <code class="language-javascript">registerNatives("com/非死book/react/bridge/JSCJavaScriptExecutor", { makeNativeMethod("initialize", executors::createJSCExecutor), });</code></pre> <p>意思是把Java中的JSCJavaScriptExecutor类的initialize方法映射为executors::createJSCExecutor的C++方法,这样当在Java中调用initialize就会在C++中执行executors::createJSCExecutor。</p> <h2>Java端初始化</h2> <p>在第一个Activity创建的时候开始进行整个Brdige的Java端的初始化,流程图如下 <img src="https://simg.open-open.com/show/c5124febdf1b4141be5fa0b80b54b462.png"></p> <p>初始化主要做几件事情</p> <ol> <li>创建JSCJavaScriptExecutor,这个是个C++包装类,会调用到C++的executors::createJSCExecutor()</li> <li>创建NativeModuleRegistry管理所有的要暴漏给JS的Java类,暴漏给JS的java类的搜集是通过ReactActivity中的getPackages实现的,详看上图</li> <li>创建ReactBridge对象,这个对象也是个C++桥梁对象,用来调用C++代码,创建过程会调用到bridge::create()方法</li> <li> <p>创建config(包含了要暴漏的所有java类的信息,json格式),并通过bridge设置到JS环境中的__fbBatchedBridgeConfig变量,这样在JS端就可以通过这个变量来获取所有的Java类信息了,然后根据config生产对应的镜像对象。</p> <p>config格式如下:</p> <pre> <code class="language-javascript">{ "remoteModuleConfig": { "MyToastAndroid": { "moduleID": 14, "methods": { "show": { "methodID": 0, "type": "remote" } }, "constants": { "LONG": 1, "SHORT": 0 } },... } } </code></pre> </li> </ol> <p>Java端还会创建一个CatalystInstanceImpl对象,这个对象用来管理所有的NativeModules以及与C++通信的桥梁ReactBrdige,类图结构如下: <img src="https://simg.open-open.com/show/040fc4d871cb25954227d209633026f3.jpg"></p> <p>几个重要的类</p> <ol> <li>NativeModuleRegistry, 维护一个mModuleInstances数组,这个数组的顺序很重要,因为这和在JS端维护的镜像对象的数组是一致的当JS调用Java的时候实际上传递的正是在这个数组中的索引</li> <li>NativeModuleReactCallBack, C++回调Java的对象,这个对象会在创建ReactBridge的时候传递给C++,当JS调用Java的方法的时候会调用这个类的方法</li> <li>ReactBridge,调用C++的桥梁</li> </ol> <p>最后catalystInstance.runJSBundle()开启JS端的初始化流程</p> <h2>JS端的初始化</h2> <p>和React Native iOS的JS初始化是一样的,因为Android和iOS的react是同享一份JS代码的,在react命令生成的react native工程的node_modules目录下面存放着所有JS的模块。在编译的时候会把所有的JS模块合并成一个大的JS文件。初始化就是在JS环境中执行这个文件。其中MessageQueue.js, BatchedBridge.js和NativeModules.js三个文件是关于JS bridge的。初始化流程如下图 <img src="https://simg.open-open.com/show/e8c6a13c05a44d5a371373ff201609b2.jpg"></p> <p>在遍历RemoteModules的时候需要为每一个映射对象生成Java暴漏的方法,因为JS是不支持消息转发,如果调用了没有实现的方法,那么就直接生成一个错误,所以要知道每一个暴漏的Module要暴漏的方法,在JS端预先生成对应的实现。在Java端初始化的时候已经在JS中注入了config信息,包括了要暴漏的类和方法名,足已生成镜像对象了。MessageQueue.js中的_genMethod方法中为每一个映射对象生成相应的方法实现。最后生成方法如下:</p> <pre> <code class="language-javascript">> NativeModules.ExportModule.hello < function () { for (var _len2 = arguments.length, args = Array(_len2), _key2 = 0; _key2 < _len2; _key2++) { args[_key2] = arguments[_key2]; } var lastArg = args.length > 0 ? args[args.length - 1] : null; var secondLastArg = args.length > 1 ? args[args.length - 2] : null; var hasSuccCB = typeof lastArg === 'function'; var hasErrorCB = typeof secondLastArg === 'function'; hasErrorCB && invariant(hasSuccCB, 'Cannot have a non-function arg after a function arg.'); var numCBs = hasSuccCB + hasErrorCB; var onSucc = hasSuccCB ? lastArg : null; var onFail = hasErrorCB ? secondLastArg : null; args = args.slice(0, args.length - numCBs); return self.__nativeCall(module, method, args, onFail, onSucc); }</code></pre> <p>当调用一个镜像对象的方法,就会调用到_nativeCall方法,而参数就是闭包生成的时候捕获的module和method等, 在Java端和JS端会保存一份关于暴漏的Java类对象信息的数组,这俩分数组的顺序是相同的,而 _nativeCall中的参数就是要调用的Java类在数组中的索引,这样在Java端就可以通过索引找到要调用的Java类了。在JS端这个数组是MessageQueue的modulesConfig,Java端是NativeModuleRegistry的mModuleInstances。</p> <h2>JS调用Java流程</h2> <p>JS会在调用native方法的时候调用 _nativeCall 然后调用 global.nativeFlushQueueImmediate(this._queue); ,其中nativeFlushQueueImmediate方法会调用到C++中,是JS调用C++的桥梁</p> <p>nativeFlushQueueImmediate方法是在C++中的JSCExecutor.cpp中注册的,我们先来看看JSCExecutor的创建过程,如下图 <img src="https://simg.open-open.com/show/d9ba68b1170aa278f82f6a7ce97ee735.png"></p> <p>在JSCExecutor的构造方法中调用了 installGlobalFunction(m_context, "nativeFlushQueueImmediate", nativeFlushQueueImmediate); ,这样就在JS环境中注册了nativeFlushQueueImmediate方法,当在JS中调用了nativeFlushQueueImmediate就会执行JSCExecutor的nativeFlushQueueImmediate C++方法,然后调用 executor->flushQueueImmediate(resStr); ,如上图所示,会回调到 OnLoad.cpp中的dispatchCallbacksToJava()方法,上图中红框中是采用了C++的闭包写法, <a href="/misc/goto?guid=4959713368630809051" rel="nofollow,noindex">参考</a></p> <pre> <code class="language-javascript">dispatchCallbacksToJava ---> makeJavaCall() ---> env->CallVoidMethod()</code></pre> <p>最后调用到CallVoidMethod的jni方法,这样就从C++调用到了Java代码了,传入的CallVoidMethod的callback参数就是在创建ReactBrdige的时候传入的NativeModuleReactCallback的java对象对应的jni对象,而gCallbackMethod就是call方法,这样就调用到了Java类NativeModuleReactCallback的call方法。哇哦~终于回到java了~,Java在通过反射最后调用实际的java方法。</p> <h2>总结</h2> <p>本文只是列出了整个Bridge比较难于理解的部分以及流程,想要详细了解具体原理还需要自己看代码,如果遇到代码中不明白的地方可以参考本文。关于React Native iOS的Objective-C和JS的通信原理请参考. <em>转载请标明出处</em></p> <p> </p> <p>来自:https://longv2go.github.io/2016/02/02/react-android-通信原理.html</p> <p> </p> <p><span style="background:rgb(189, 8, 28) url("data:image/svg+xml; border-radius:2px; border:medium none; color:rgb(255, 255, 255); cursor:pointer; display:none; font:bold 11px/20px "Helvetica Neue",Helvetica,sans-serif; left:30px; opacity:0.85; padding:0px 4px 0px 0px; position:absolute; text-align:center; text-indent:20px; top:231px; width:auto; z-index:8675309">Save</span></p>