前言

從原理到應(yīng)用復(fù)盤(pán)一下自己做過(guò)的所有項(xiàng)目，希望能讓我自己過(guò)兩年仍然能看懂現(xiàn)在寫(xiě)的代碼哈哈。在項(xiàng)目里我只負(fù)責(zé)了Android的開(kāi)發(fā)包括插件開(kāi)發(fā)和集成，ios沒(méi)摸到，有機(jī)會(huì)也得自己玩下，但是這篇文章不會(huì)接觸。

技術(shù)選型

現(xiàn)在Hybrid混合開(kāi)發(fā)框架很多，Apche Cordova/React Native/Flutter等等等等。然而公司需求是2018年6月提的，F(xiàn)lutter 1.0在半年之后才出生，所以當(dāng)時(shí)團(tuán)隊(duì)TL比較了RN與Cordova后基于以下幾點(diǎn)選擇了Cordova。

• 學(xué)習(xí)成本低，項(xiàng)目周期比較緊，只有1個(gè)月就要發(fā)版本，團(tuán)隊(duì)內(nèi)沒(méi)有熟悉RN的成員，學(xué)習(xí)成本低開(kāi)發(fā)時(shí)間短非常重要
• 技術(shù)成熟，文檔多不容易踩坑（當(dāng)然現(xiàn)在RN也很成熟，但是當(dāng)時(shí)RN的人確實(shí)沒(méi)有很多，生態(tài)不成熟）

我們的應(yīng)用跑在一臺(tái)定制的Android終端，性能不是很好，在最后某些js動(dòng)畫(huà)場(chǎng)景里，以及一些js-native的調(diào)用里卡的不行，最后優(yōu)化了下，效果也算還不錯(cuò)。這里建議如果對(duì)性能要求很高的項(xiàng)目，一定慎重考慮Cordova這種webview方案

項(xiàng)目最后選擇了React + Mirrorx + Cordova的方案（當(dāng)時(shí)有Dva, 但是由于Dva沒(méi)有英文文檔，而我們的項(xiàng)目是需要美國(guó)分團(tuán)隊(duì)共同維護(hù)的，所以選擇了Mirrorx）

技術(shù)原理

架構(gòu)圖

本質(zhì)上其實(shí)就是往app里面塞一個(gè)webview，通過(guò)file協(xié)議， 本地加載index.html

那么這里會(huì)有三個(gè)問(wèn)題

• 如何本地加載url對(duì)應(yīng)的資源
• webview如何使用js調(diào)用app原生api（JSBridge）
• app原生api如何回調(diào)webview中的js
• 多個(gè)plugin的情況下，cordova是如何通過(guò)cordova.exec(...’pluginName’...)定位到相應(yīng)的plugin的 以下帶著問(wèn)題一個(gè)個(gè)進(jìn)行解釋

1. 如何本地加載url對(duì)應(yīng)的資源

我們項(xiàng)目中通過(guò)eject暴露Webapck配置， 配置打包路徑直接打進(jìn)www文件夾。 通過(guò)Android的webview.loadUrl方法通過(guò)file協(xié)議load本地index.html。在Google inject中也可以看到對(duì)應(yīng)的url. 對(duì)應(yīng)的cordova代碼如下

 public class CordovaViewTestActivity extends Activity implements CordovaInterface {
     CordovaWebView cwv;
     /* Called when the activity is first created. */
     @Override
     public void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.main);
         cwv = (CordovaWebView) findViewById(R.id.tutorialView);
         cwv.loadUrl("file:///android_asset/www/index.html");
     }

2. webview如何使用js調(diào)用app原生api

2.1 通過(guò)addJavascriptInterface 及 @JavascriptInterface實(shí)現(xiàn)

2.2 通過(guò)WebClientChrome中的三個(gè)方法onJsAlert, onJsConfirm, onJsPrompt實(shí)現(xiàn)

當(dāng)chromium webkit內(nèi)核的webview調(diào)用window.alert, window.confirm, window.prompt方法時(shí)，對(duì)應(yīng)的WebClientChrome的那三個(gè)方法同樣會(huì)被執(zhí)行

在cordova中會(huì)首先判斷有沒(méi)有設(shè)置navtiveApi

var nativeApi = this._cordovaNative || require('cordova/android/promptbasednativeapi');

在Android部分

var msgs = nativeApiProvider.get().exec(bridgeSecret, service, action, callbackId, argsJson);
// If argsJson was received by Java as null, try again with the PROMPT bridge mode.
// This happens in rare circumstances, such as when certain Unicode characters are passed over the bridge on a Galaxy S2.  See CB-2666.
if (jsToNativeBridgeMode == jsToNativeModes.JS_OBJECT && msgs === "@Null arguments.") {
    androidExec.setJsToNativeBridgeMode(jsToNativeModes.PROMPT);
    androidExec(success, fail, service, action, args);
    androidExec.setJsToNativeBridgeMode(jsToNativeModes.JS_OBJECT);
} else if (msgs) {
    messagesFromNative.push(msgs);
    // Always process async to avoid exceptions messing up stack.
    nextTick(processMessages);
}

如果有nativeApi即設(shè)備支持@JavascriptInterface注解, 則走addJavascriptInterface，否則走onJsPrompt

3. app原生api如何回調(diào)webview中的js

js端生成callback function id，傳給native, native需要回調(diào)js時(shí)，回調(diào)對(duì)應(yīng)的callbackId給js

    private String callbackId; // 在js端生成，保存在native端
    private CordovaWebView webView;
    protected boolean finished; //這個(gè)callback是否結(jié)束，如果結(jié)束在js端（cordova.js）就會(huì)把這個(gè)callbackid從列表中刪掉,否則這個(gè)callback將一直存在，也就是說(shuō)明你可以用這個(gè)callbackContext一直和js保持通信

回調(diào)方式：

/** Uses webView.loadUrl("javascript:") to execute messages. */
public static class LoadUrlBridgeMode extends BridgeMode {

/** Uses webView.evaluateJavascript to execute messages. */
public static class EvalBridgeMode extends BridgeMode {

public static class OnlineEventsBridgeMode extends BridgeMode

4. 多個(gè)plugin的情況

多個(gè)plugin的情況下，cordova是如何通過(guò)cordova.exec(...’pluginName’...)定位到相應(yīng)的plugin的

當(dāng)Cordova框架啟動(dòng)時(shí)候，CordovaActivity類(lèi)中的onCreate方法調(diào)用loadUrl方法。在第一次loadUrl方法時(shí)，就會(huì)去初始化PluginManager并加載plugin，PluginManager加載plugin，將plugin的Class名字保存到一個(gè)hashmap中，用service名字作為key值。當(dāng)JS端通過(guò)JavascriptInterface接口的SystemExposedJsApi對(duì)象請(qǐng)求Android時(shí)，PluginManager會(huì)從hashmap中查找到plugin，如果該plugin還未實(shí)例化，利用java反射機(jī)制實(shí)例化該plugin，并執(zhí)行plugin的execute方法。

關(guān)于踩到的坑

1. 打包路徑配置問(wèn)題

cordova build的時(shí)候會(huì)默認(rèn)使用項(xiàng)目www目錄作為資源目錄，打包進(jìn)assets中。 項(xiàng)目工期緊，直接用了cra創(chuàng)建的項(xiàng)目，我們使用eject，再修改打包路徑（實(shí)際當(dāng)時(shí)有其他插件可以暴露打包路徑配置）。

// webpack.config.prod.js
module.exports = {
    ...
    output: {
        ...
        // The build folder.
        path: resolveApp('www'),
    }
}

2. success不回調(diào)問(wèn)題

場(chǎng)景： 我們項(xiàng)目集成其他項(xiàng)目組的自研plugin的功能后，用戶輸入device ID和divice Name后，點(diǎn)擊connect按鈕，就可以通過(guò)mobile連接上其他項(xiàng)目組的硬件設(shè)備

前端調(diào)用test.connect(deviceID, deviceName, callback), 其中callback的邏輯是接收并判斷java端傳回的message。在連接上device后， java使用contextCallback.success(”success”)來(lái)進(jìn)行回調(diào) ，callback接收到message為success, 就更改mobile端我們前端的相應(yīng)狀態(tài)為連接成功

第一次連接之后，即java調(diào)用了contextCallback.success(“success”), 然后js中調(diào)用了callback(‘success’) ，項(xiàng)目頁(yè)面顯示已連接， 斷開(kāi)后，第二次再次調(diào)用contextCallback.success(“success”)無(wú)法正常連接，無(wú)法正常調(diào)用js這邊的callback

原因：

finished一開(kāi)始沒(méi)有初始化，走下面的else，被賦值為true， 然后調(diào)用webView.sendResult，第二次調(diào)用就直接return了。

解決方案：keepCallback (當(dāng)時(shí)官方文檔沒(méi)有提到callback只能調(diào)一次的問(wèn)題，翻源碼才看到)

以上就是Apache Cordova Android原理應(yīng)用實(shí)例詳解的詳細(xì)內(nèi)容，更多關(guān)于Apache Cordova Android的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！