React Native桥接器初探

本文假设你已经有一定的React Native基础,并且想要了解React Native的JS和原生代码之间是如何交互的。

React Native的工作线程

  • shadow queue:布局在这个线程工作
  • main thread:UIKit在这里工作
  • Javascript thread:Js代码在这里工作

另外每一个原生模块都有自己的一个工作GCD queue,除非你明确指定它的工作队列

*shadow queue*实际是一个GCD queue,而不是一个线程。

原生模块

如果你还不知道如何创建原声模块,我建议你看看官方文档

下面是一个叫做Person的原生模块,既可以被js调用,也可以调用js代码。

@interface Person : NSObject <RCTBridgeModule>
@end

@implementation Logger

RCT_EXPORT_MODULE()

RCT_EXPORT_METHOD(greet:(NSString *)name)
{
  NSLog(@"Hi, %@!", name);
  [_bridge.eventDispatcher sendAppEventWithName:@"greeted"
                                           body:@{ @"name": name }];
}

@end

下面,我们主要看看代码里用到的两个宏定义:RCT_EXPORT_MODULERCT_EXPORT_METHOD。看看他们是如何工作的。

RCT_EXPORT_MODULE([js_name])

这个宏的功能就和它名字说的一样,到处一个模块。但是export是什么意思呢?它的意思是让React Native的bridge(桥接)感知到原生模块。

它的定义其实非常的简单:

#define RCT_EXPORT_MODULE(js_name) \
  RCT_EXTERN void RCTRegisterModule(Class); \
  + (NSString \*)moduleName { return @#js_name; } \
  + (void)load { RCTRegisterModule(self); }

它的作用:

  • 首先它声明了RCTRegisterModuleextern方法,也就是说这个方法的实现在编译的时候不可知,而在link的时候才可知。
  • 声明了一个方法moduleName,这个方法返回可选的宏定义参数js_name,一般是你希望有一个专门的模块名称,而不是默认的ObjC类名的时候使用。
  • 最后,声明了一个load方法(当app被加载进内存的时候,load方法也会被调用)。在这个方法里调用RCTRegisterModule方法来让RN的bridge感知到这个模块。

RCT_EXPORT_METHOD(method)

这个宏更有意思,它并给你的模块添加任何实际的方法。它创建了一个新的方法,这个新的方法基本上是这样的:

+ (NSArray *)__rct_export__120
{
    return @[@"", @"log: (NSString *)message"];
}

这个被load方法生成的方法的名称由前缀(__rct_export__)和一个可选的js_name(现在是空的)和声明的行号(比如12)和__COUNTER__宏拼接在一起组成。

这个新生成的方法的作用就是返回一个数组,这个数组包含一个可选的js_name(在本例中是空的)和方法的签名。签名说的那一堆是为了避免方法崩溃。

即使是这么复杂的生成算法,如果你使用了*category*的话也难免会有两个方法的名称是一样的。不过这个概率非常低,并且也不会产生什么不可控的行为。虽然Xcode会这么警告。

Runtime

这一步只做一件事,那就是给React Native的桥接模块提供信息。这样它就可以找到原生模块里export出来的全部信息:modulesmethods,而且这些全部发生在load的时候。

下图是React Native桥接的依赖图


初始化模块

方法RCTRegisterModule方法就是用来把类添加到一个数组里,这样React Native桥接器实例创建之后可以找到这个模块。它会遍历模块数组,创建每个模块的实例,并在桥接器里保存它的引用,并且每个模块的实例也会保留桥接器的实例。并且该方法还会检查模块是否指定了运行的队列,如果没有指定那么就运行在一个新建的队列上,与其他队列分割。

NSMutableDictionary *modulesByName; // = ...
for (Class moduleClass in RCTGetModuleClasses()) {
  // ...
  module = [moduleClass new];
  if ([module respondsToSelector:@selector(setBridge:)]) {
    module.bridge = self;
  }
  modulesByName[moduleName] = module;
  // ...
}

配置原生模块

一旦在后台线程里有了模块实例,我们就列出每个模块的全部方法,之后调用__rct_export__开始的方法,这样我们就有一个该方法签名的字符串。这样我们后续就可以获得参数的实际类型。在运行时,我们只会知道参数的类型是id,按照上面的方法就可以获得参数的实际类型,比如本例的是NSString*

unsigned int methodCount;
Method *methods = class_copyMethodList(moduleClass, &methodCount);
for (unsigned int i = 0; i < methodCount; i++) {
  Method method = methods[i];
  SEL selector = method_getName(method);
  if ([NSStringFromSelector(selector) hasPrefix:@"__rct_export__"]) {
    IMP imp = method_getImplementation(method);
    NSArray *entries = ((NSArray *(*)(id, SEL))imp)(_moduleClass, selector);
    //...
    [moduleMethods addObject:/* Object representing the method */];
  }
}

初始化Javascript执行器

JavaScript执行器有一个setUp方法。用这个方法可以执行很多耗费资源的任务,比如在后台线程里初始化JavaScriptCore。由于只有active的执行器才可以接受到setUp的调用,所以也节约了很多的资源。

JSGlobalContextRef ctx = JSGlobalContextCreate(NULL);
_context = [[RCTJavaScriptContext alloc] initWithJSContext:ctx];

注入Json配置

模块的配置都是Json形式的,如:

{
  "remoteModuleConfig": {
    "Logger": {
      "constants": { /* If we had exported constants... */ },
      "moduleID": 1,
      "methods": {
        "requestPermissions": {
          "type": "remote",
          "methodID": 1
        }
      }
    }
  }
}

这些都作为全局变量存储在JavaScript VM里,因此当桥接器的Js侧代码初始化完毕的时候它可以用这些信息来创建原生模块。

加载JavaScript代码

可以获得代码的地方只有两个,在开发的时候从packager下载代码,在产品环境下从磁盘加载代码。

执行JavaScript代码

一旦所有的准备工作就绪,我们就可以把App的代码都加载到JavaScript Core里解析,执行。在最开始执行的时候,所有的CommonJS模块都会被注册(现在你写的是ES6的模块,不是CommonJS,但是最后会转码为ES5),并require入口文件。

JSValueRef jsError = NULL;
JSStringRef execJSString = JSStringCreateWithCFString((__bridge CFStringRef)script);
JSStringRef jsURL = JSStringCreateWithCFString((__bridge CFStringRef)sourceURL.absoluteString);
JSValueRef result = JSEvaluateScript(strongSelf->_context.ctx, execJSString, NULL, jsURL, 0, &jsError);
JSStringRelease(jsURL);
JSStringRelease(execJSString);

JavaScript模块

这个时候,上例中的原生模块就可以在NativeModules对象里调用了。

var { NativeModules } = require('react-native');
var { Person } = NativeModules;

Person.greet('Tadeu');

当你调用一个原生模块的方法的时候,它会在一个队列里执行。其中包含模块名、方法名和调用这个方法需要的全部参数。在JavaScript执行结束的时候原生代码继续执行。

调用周期

下面看看如果我们调用上面的代码会发生什么:


代码的调用从Js开始,之后开始原生代码的执行。Js传入的回调会通过桥接器(原生模块使用_bridge实例调用enqueueJSCall:args:)传回到JS代码。

注意:你如果看过文档,或者亲自实践过的话你就会知道也有从原生模块调用JS的情况。这个是用vSYNC实现的。但是这些为了改善启动时间被删除了。

参数类型

从原生调用JS的情况更简单一些,参数是做为JSON例的一个数组传递的。但是从JS到原生的调用里,我们需要原生的类型。但是,如上文所述,对于类的对象(结构体的对象),运行时并不能通过NSMethodSignature给我们足够的信息,我们只有字符串类型。

我们使用正则表达式从方法的签名里提取类型,然后我们使用RCTConvert工具类来实际转化参数的类型。这个工具类会把JSON里的数据转化成我们需要的类型。

我们使用objc_msgSend来动态调用方法。如果是struct的话,则使用NSInvocation来调用。

一旦我们得到了全部参数的类型,我们使用另外一个NSInvocation来调用目标模块的方法,并传入全部的参数。比如:

// If you had the following method in a given module, e.g. `MyModule`
RCT_EXPORT_METHOD(methodWithArray:(NSArray *) size:(CGRect)size) {}

// And called it from JS, like:
require('NativeModules').MyModule.method(['a', 1], {
  x: 0,
  y: 0,
  width: 200,
  height: 100
});

// The JS queue sent to native would then look like the following:
// ** Remember that it's a queue of calls, so all the fields are arrays **
@[
  @[ @0 ], // module IDs
  @[ @1 ], // method IDs
  @[       // arguments
    @[
      @[@"a", @1],
      @{ @"x": @0, @"y": @0, @"width": @200, @"height": @100 }
    ]
  ]
];

// This would convert into the following calls (pseudo code)
NSInvocation call
call[args][0] = GetModuleForId(@0)
call[args][1] = GetMethodForId(@1)
call[args][2] = obj_msgSend(RCTConvert, NSArray, @[@"a", @1])
call[args][3] = NSInvocation(RCTConvert, CGRect, @{ @"x": @0, ... })
call()

线程

默认情况下,每一个模块都有自己的GCD queue。除非在模块中通过-methodQueue方法指定模块要运行的队列。有一个例外是View Managers(就是继承了RCTViewManager)的类,会默认运行在Shadow Queue里。

目前的线程规则是这样的:

  • -init-setBridge:保证会在main thread里执行
  • 所有导出的方法都会在目标队列里执行
  • 如果你实现了RCTInvalidating协议,invalidate也会在目标队列里执行
  • -dealloc方法在哪个线程执行被调用

当JS执行一堆的方法之后,这些方法会根据目标队列分组,之后被并行分发:

// group `calls` by `queue` in `buckets`
for (id queue in buckets) {
  dispatch_block_t block = ^{
    NSOrderedSet *calls = [buckets objectForKey:queue];
    for (NSNumber *indexObj in calls) {
      // Actually call
    }
  };

  if (queue == RCTJSThread) {
    [_javaScriptExecutor executeBlockOnJavaScriptQueue:block];
  } else if (queue) {
    dispatch_async(queue, block);
  }
}

总结

本文还只是对桥接器如何工作的一个简单描述。希望对各位能有所帮助。

原文:https://tadeuzagallo.com/blog/react-native-bridge/

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,233评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,013评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,030评论 0 241
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,827评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,221评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,542评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,814评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,513评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,225评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,497评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,998评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,342评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,986评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,055评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,812评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,560评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,461评论 2 266

推荐阅读更多精彩内容