React Native 是 Facebook 新開源的框架,讓開發者直接用 JavaScript 打造原生 App。先不論它後續能否被大眾接受,光是原始碼裡大量的設計思路與實作手法就值得研究。本文先從最基礎的 JavaScript–Objective-C 通訊機制(以下簡稱 JS/OC)看起。
React Native 使用 iOS 自帶的 JavaScriptCore 作為 JS 解析引擎,卻沒有採用 JavaScriptCore 提供的 JS 與 OC 互調特性,而是自己實作了一套機制。這套機制的通用性很強,任何 JS 引擎都能用;在沒有 JavaScriptCore 的環境下甚至可以用 WebView 取代——專案裡確實已有以 WebView 作為解析引擎的實作,推測是為了相容 iOS 7 以下沒有 JavaScriptCore 的版本。
普通的 JS–OC 通訊其實很單純。OC 要傳資訊給 JS 有現成介面,例如 WebView 的 -stringByEvaluatingJavaScriptFromString: 可以直接在當前 context 執行一段腳本並取得回傳值,這個回傳值就等於 JS 交給 OC 的訊息。React Native 以此為基礎,透過種種手段做到:在 OC 定義一個模組方法,JS 可以直接呼叫,而且能無縫接回 callback。
舉例來說,OC 定義模組 RCTSQLManager,其中有個 -query:successCallback: 方法,JS 端可以直接呼叫 RCTSQLManager.query 並透過 callback 取得結果:
@implementation RCTSQLManager
- (void)query:(NSString *)queryData successCallback:(RCTResponseSenderBlock)responseSender
{
RCT_EXPORT();
NSString *ret = @"ret";
responseSender(ret);
}
@end
OC 必須先告訴 JS 有哪些模組、模組裡有哪些方法,JS 才可能去呼叫。這裡的做法是 OC 產生一份模組配置表交給 JS,表內含所有模組與方法資訊:
{
"remoteModuleConfig": {
"RCTSQLManager": {
"methods": {
"query": { "type": "remote", "methodID": 0 }
},
"moduleID": 4
}
}
}
OC 端與 JS 端各有一個 bridge,兩邊都持有同一份配置表。JS 呼叫 OC 模組方法時,透過 bridge 把模組與方法轉成模組 ID 與方法 ID 傳給 OC,OC 再依配置表找到對應方法執行。

那這份配置表是怎麼自動產生的?答案是:新增 OC 模組時,JS 與 OC 都不需要手動到任何地方登記,只要專案裡有這個模組,它就會被收進配置表。分兩個步驟。
步驟一:取出所有模組類。每個模組類都實作 RCTBridgeModule 介面,因此可以用 runtime 的 objc_getClassList 或 objc_copyClassList 取得專案內所有類別,逐一判斷是否實作該介面,實作在 RCTBridgeModuleClassesByModuleID() 中。
步驟二:取出要暴露給 JS 的方法。直覺做法是給要暴露的方法名加統一前綴(例如 RCTExport_),再用 class_getInstanceMethod 取出所有方法名做篩選——但每個方法都得加前綴,寫起來噁心。React Native 用了另一招:編譯屬性 __attribute__。
前面的範例裡,模組方法中有個 RCT_EXPORT() 巨集,加上它就完成暴露,不需其他規則。它的定義是:
#define RCT_EXPORT(JS_name) __attribute__((used, section("__DATA,RCTExport"))) \
static const char *__rct_export_entry__[] = { __func__, #JS_name }
這個巨集用編譯屬性在二進位檔中新增一個屬於 __DATA 段、名為 RCTExport 的 section,並把當前方法名塞進去。編譯器處理 __attribute__ 時會把對應內容寫進產物,效果可以從 linkmap 看出來:
# Sections: # Address Size Segment Section 0x10011EFA0 0x00000330 __DATA RCTExport ... 0x10011EFA0 0x00000010 [ 4] -[RCTStatusBarManager setStyle:animated:].__rct_export_entry__ 0x10011EFD0 0x00000010 [ 7] -[RCTAlertManager alertWithArgs:callback:].__rct_export_entry__
資料段多出的 RCTExport 段,內容正是各個要暴露給 JS 的方法,這些資訊在 runtime 讀得到。做法是於 RCTBridge.m 的 RCTExportedMethodsByModuleID() 中取出每個方法的類名與方法名。整體的模組類/方法擷取實作在 RCTRemoteModulesConfig() 裡。
接著看包含 callback 的完整流程:

BatchedBridgeFactory.js 的 _createBridgedModule 中,僅 24 行就搞定。_handleRequestNumber:moduleID:methodID:params:。以 -(void)select:(int)index response:(RCTResponseSenderBlock)callback 為例,目標參數型別是 int 與 block,JS 傳來的是 NSNumber 與 NSString(CallbackID);於是 NSNumber 轉成 int,CallbackID 字串轉成一個 block,block 的內容就是把回傳值與 CallbackID 送回 JS。參數組裝完成後,透過 NSInvocation 動態呼叫對應的 OC 模組方法。
invokeCallbackAndReturnFlushedQueue。濃縮成一句話:JS 函式呼叫轉成 ModuleID/MethodID → callback 轉成 CallbackID → OC 依 ID 找到方法 → 處理參數 → 執行 OC 方法 → 回傳 CallbackID → JS 依 CallbackID 執行 callback。
第 4 步留下一個疑問:JS 究竟怎麼把資料交給 OC?答案是靠回傳值。JS 不會主動推資料給 OC,而是在呼叫 OC 方法時把 ModuleID、MethodID 等資訊放進一個佇列;等 OC 過來呼叫 JS 的任意方法時,再把這個佇列回傳給 OC,OC 才執行佇列裡那些方法。
一開始我也想不通:設計成 JS 無法直接呼叫 OC,非得等 OC 來呼叫 JS 時才能靠回傳值觸發,程式還跑得動嗎?後來對照純 native 開發的事件機制就理解了——native 開發裡程式碼只在事件觸發時執行,可能是啟動事件、觸碰事件、timer、系統事件或回調事件。React Native 中這些事件發生時,OC 都會呼叫 JS 對應的模組方法處理,處理完再執行 JS 想讓 OC 做的事;沒有事件,就不會有任何程式碼被執行。這與 native 的事件驅動模型是一致的。
補充一下 OC 呼叫 JS 的方向:配置表除了上述 OC 的 remoteModules,也保存 JS 的 localModules。OC 呼叫 JS 模組方法時同樣是傳 ModuleID 與 MethodID,都會走到 -enqueueJSCall:args:,把兩個 ID 與參數交給 JS 的 BatchedBridge.callFunctionReturnFlushedQueue,原理與 JS 呼叫 OC 幾乎相同。
React Native 的 JS–OC 通訊機制大致如此,關鍵詞是:模組化、模組配置表、傳遞 ID、封裝呼叫、事件驅動。不論設計思路還是實作手法,都很值得借鏡。