[[345068]]

一、jsbridge 定義

JSBridge 是一種 JS 實(shí)現(xiàn)的 Bridge，連接著橋兩端的 Native 和 H5。它在 APP 內(nèi)方便地讓 Native 調(diào)用 JS，JS 調(diào)用 Native ，是雙向通信的通道。JSBridge 主要提供了 JS 調(diào)用 Native 代碼的能力，實(shí)現(xiàn)原生功能如查看本地相冊、打開攝像頭、指紋支付等。

二、JSBridge 用途

JSBridge 就像其名稱中的『Bridge』的意義一樣，是 Native 和非 Native 之間的橋梁，它的核心是 構(gòu)建 Native 和非 Native 間消息通信的通道，而且是 雙向通信的通道。

雙向通信的通道:

1) JS 向 Native 發(fā)送消息: 調(diào)用相關(guān)功能、通知 Native 當(dāng)前 JS 的相關(guān)狀態(tài)等。

2) Native 向 JS 發(fā)送消息: 回溯調(diào)用結(jié)果、消息推送、通知 JS 當(dāng)前 Native 的狀態(tài)等。

H5與Native交互如下圖： 

三、JSBridge 的實(shí)現(xiàn)原理

JavaScript 是運(yùn)行在一個單獨(dú)的 JS Context 中（例如，WebView 的 Webkit 引擎、JSCore）。由于這些 Context 與原生運(yùn)行環(huán)境的天然隔離，我們可以將這種情況與 RPC（Remote Procedure Call，遠(yuǎn)程過程調(diào)用）通信進(jìn)行類比，將 Native 與 JavaScript 的每次互相調(diào)用看做一次 RPC 調(diào)用。

在 JSBridge 的設(shè)計(jì)中，可以把前端看做 RPC 的客戶端，把 Native 端看做 RPC 的服務(wù)器端，從而 JSBridge 要實(shí)現(xiàn)的主要邏輯就出現(xiàn)了：通信調(diào)用（Native 與 JS 通信） 和句柄解析調(diào)用。

四、JSBridge 的通信原理

一、JavaScript 調(diào)用 Native的方式

JavaScript 調(diào)用 Native 的方式，主要有兩種：注入 API 和 攔截 URL SCHEME。

1､注入API

注入 API 方式的主要原理是，通過 WebView 提供的接口，向JavaScript 的 Context（window）中注入對象或者方法，讓 JavaScript 調(diào)用時，直接執(zhí)行相應(yīng)的 Native 代碼邏輯，達(dá)到 JavaScript 調(diào)用 Native 的目的。

對于 iOS 的 UIWebView，實(shí)例如下：

JSContext *context = [uiWebView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"]; 
context[@"postBridgeMessage"] = ^(NSArray<NSArray *> *calls) { 
// Native 邏輯 
}; 
前端調(diào)用方式： 
window.postBridgeMessage(message); 

2､攔截 URL SCHEME

先解釋一下 URL SCHEME：URL SCHEME是一種類似于url的鏈接，是為了方便app直接互相調(diào)用設(shè)計(jì)的，形式和普通的 url 近似，主要區(qū)別是 protocol 和 host 一般是自定義的，

例如: qunarhy://hy/url?url=ymfe.tech，protocol 是 qunarhy，host 則是 hy。

攔截 URL SCHEME 的主要流程是：Web 端通過某種方式（例如 iframe.src）發(fā)送 URL Scheme 請求，之后 Native 攔截到請求并根據(jù) URL SCHEME（包括所帶的參數(shù)）進(jìn)行相關(guān)操作。

在時間過程中，這種方式有一定的缺陷：

1) 使用 iframe.src 發(fā)送 URL SCHEME 會有 url 長度的隱患。

2) 創(chuàng)建請求，需要一定的耗時，比注入 API 的方式調(diào)用同樣的功能，耗時會較長。

因此：JavaScript 調(diào)用 Native 推薦使用注入 API 的方式

二、Native 調(diào)用 JavaScript 的方式

相比于 JavaScript 調(diào)用 Native， Native 調(diào)用 JavaScript 較為簡單，直接執(zhí)行拼接好的 JavaScript 代碼即可。

從外部調(diào)用 JavaScript 中的方法，因此 JavaScript 的方法必須在全局的 window 上。

對于 iOS 的 UIWebView，示例如下：

result = [uiWebview stringByEvaluatingJavaScriptFromString:javaScriptString]; 
* javaScriptString為JavaScript 代碼串 

對于 iOS 的 WKWebView，示例如下：

[wkWebView evaluateJavaScript:javaScriptString completionHandler:completionHandler]; 

三、通信原理總結(jié)

通信原理是 JSBridge 實(shí)現(xiàn)的核心

1）JavaScript 調(diào)用 Native 推薦使用 注入 API 的方式（iOS6 忽略，Android 4.2以下使用 WebViewClient 的 onJsPrompt 方式）。

2）Native 調(diào)用 JavaScript 則直接執(zhí)行拼接好的 JavaScript 代碼即可。

四、JSBridge 接口實(shí)現(xiàn)

JSBridge 的接口主要功能有兩個：調(diào)用 Native（給 Native 發(fā)消息） 和 被 Native 調(diào)用（接收 Native 消息）。因此，JSBridge 可以設(shè)計(jì)如下：

window.JSBridge = { 
  // 調(diào)用 Native 
  invoke: function(msg) { 
    // 判斷環(huán)境，獲取不同的 nativeBridge 
    nativeBridge.postMessage(msg); 
  }, 
  receiveMessage: function(msg) { 
    // 處理 msg 
  } 
}; 

在上面的文章中，提到過 RPC 中有一個非常重要的環(huán)節(jié)是 句柄解析調(diào)用 ，這點(diǎn)在 JSBridge 中體現(xiàn)為 句柄與功能對應(yīng)關(guān)系。同時，我們將句柄抽象為 橋名（BridgeName），最終演化為 一個 BridgeName 對應(yīng)一個 Native 功能或者一類 Native 消息?；诖它c(diǎn)，JSBridge 的實(shí)現(xiàn)可以優(yōu)化為如下：

window.JSBridge = { 
  // 調(diào)用 Native 
  invoke: function(bridgeName, data) { 
  // 判斷環(huán)境，獲取不同的 nativeBridge 
    nativeBridge.postMessage({ 
      bridgeName: bridgeName, 
      data: data || {} 
    }); 
  }, 
  receiveMessage: function(msg) { 
    var bridgeName = msg.bridgeName, 
    data = msg.data || {}; 
  // 具體邏輯 
  } 
}; 

對于 JSBridge 的 Callback ，其實(shí)就是 RPC 框架的回調(diào)機(jī)制。當(dāng)然也可以用更簡單的 JSONP 機(jī)制解釋：

當(dāng)發(fā)送 JSONP 請求時，url 參數(shù)里會有 callback 參數(shù)，其值是 當(dāng)前頁面唯一 的，而同時以此參數(shù)值為 key 將回調(diào)函數(shù)存到 window 上，隨后，服務(wù)器返回 script 中，也會以此參數(shù)值作為句柄，調(diào)用相應(yīng)的回調(diào)函數(shù)。

整體流程：

在 Native 端配合實(shí)現(xiàn) JSBridge 的 JavaScript 調(diào)用 Native 邏輯也很簡單，主要的代碼邏輯是：接收到 JavaScript 消息 => 解析參數(shù)，拿到 bridgeName、data 和 callbackId => 根據(jù) bridgeName 找到功能方法，以 data 為參數(shù)執(zhí)行 => 執(zhí)行返回值和 callbackId 一起回傳前端。

Native調(diào)用 JavaScript 也同樣簡單，直接自動生成一個唯一的 ResponseId，并存儲句柄，然后和 data 一起發(fā)送給前端即可。

五、JSBridge 如何引用

對于 JSBridge 的引用，常用有兩種方式，各有利弊。

1) 由 Native 端進(jìn)行注入

注入方式和 Native 調(diào)用 JavaScript 類似，直接執(zhí)行橋的全部代碼。

優(yōu)點(diǎn)：橋的版本很容易與 Native 保持一致，Native 端不用對不同版本的 JSBridge 進(jìn)行兼容；與此同時，

缺點(diǎn)：注入時機(jī)不確定，需要實(shí)現(xiàn)注入失敗后重試的機(jī)制，保證注入的成功率，同時 JavaScript 端在調(diào)用接口時，需要優(yōu)先判斷 JSBridge 是否已經(jīng)注入成功。

2) 由 JavaScript 端引用

直接與 JavaScript 一起執(zhí)行。與由 Native 端注入正好相反。

優(yōu)點(diǎn)：JavaScript 端可以確定 JSBridge 的存在，直接調(diào)用即可；

缺點(diǎn)：如果橋的實(shí)現(xiàn)方式有更改，JSBridge 需要兼容多版本的 Native Bridge 或者 Native Bridge 兼容多版本的 JSBridge。