Android webView與js 交互以及jsbridge框架源碼分析

原文鏈接:http://blog.csdn.net/qq_22329521/article/details/73610277

最近在處理android webView與js的通信上的問題,作為總結(jié)

1.簡(jiǎn)單篇

如何實(shí)現(xiàn)簡(jiǎn)單的android 調(diào)用js 與js調(diào)用android

   讓webview做一下操作
  private void init(Context context){
        WebSettings setting =getSettings();
        setting.setJavaScriptEnabled(true);//支持js
        setWebViewClient(new WebClient(this));
        setWebChromeClient(new WebChromeClient());
        //添加js調(diào)用android的方法這是關(guān)鍵 前者是個(gè)對(duì)象,后者是個(gè)字符串 在js中是在window.android可以直接獲取到
        addJavascriptInterface(new JavaScriptinterface(context,this),
                "android");
        //這是開啟js的調(diào)試下面再講
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            setWebContentsDebuggingEnabled(true);
        }
    }


  public class JavaScriptinterface{
    Context context;

    public JavaScriptinterface(Context c) {
        context = c;
    }
    //這個(gè)注解可以點(diǎn)擊進(jìn)去看官方描述 是 帶有此注釋的標(biāo)記可用于JavaScript代碼
      @JavascriptInterface
      public void toastMessage(String message) {
          Toast.makeText(getApplicationContext(), message, Toast.LENGTH_LONG).show();
      }
  }

如果js 要調(diào)用這個(gè)方法調(diào)用window.anroid.toastMessage('即可')
<script>
function showToast() {
   
    android.toastMessage('hhh');
}
</script>

注意這里的toastMessage 是JavaScriptinterface 中被@JavascriptInterface注解的toastMessage方法

這是js調(diào)用android中的方法

android 調(diào)用js 的方法


<script>
function jsalert(data) {
    alert(data);
}
</script>
//java這樣調(diào)用即可 方法前需要加javascript
webview.loadUrl('javascript:jsalert('111')')

注意點(diǎn)

  1. 需要在主線程調(diào)用才會(huì)生效
  2. 如果在oncreate中直接調(diào)用loadurl不會(huì)生效原因是 webview需要加載完成才能調(diào)用webview加載完成的回調(diào)函數(shù)是在webclinet 中
  3. 如果alert沒效果,需要在setWebChromeClient(new WebChromeClient());
String javascriptCommand='javascript:jsalert('111')';
    if (Thread.currentThread() == Looper.getMainLooper().getThread()) {
            this.loadUrl(javascriptCommand);
        }else{
            ((Activity) getContext()).runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    //此時(shí)已在主線程中,可以更新UI了
                    loadUrl(javascriptCommand);
                }
            });
        }
    }
    
public class JsWebClient extends WebViewClient {
    public static final String TAG="JsWebClient";
    private JsWebView jsWebView;

    public JsWebClient(JsWebView jsWebView) {
        this.jsWebView = jsWebView;
    }

    @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        Log.e(TAG,url);
      return super.shouldOverrideUrlLoading(view,url);
    }
    //當(dāng)這個(gè)回調(diào)函數(shù)觸發(fā)了webview才可以發(fā)送消息
    @Override
    public void onPageFinished(WebView view, String url) {
        super.onPageFinished(view, url);

    }
}

簡(jiǎn)單封裝

js與android中的通信還是通過字符串來處理的

//傳遞過來
基本的數(shù)據(jù)格式大致為
{
   type:type,//類型
   funName:funName,//當(dāng)js調(diào)android 讓android是否有回調(diào)方法到j(luò)s中的某個(gè)方法
   option:option,//object,內(nèi)部帶個(gè)個(gè)參數(shù)
}

//回復(fù)js
{
    type:'success'/'fail'...
    data:data
}



 @JavascriptInterface
    public void postMessage(String data) {
        try {
            JSONObject jsonObject = new JSONObject(data);
            String type = jsonObject.getString("type");
            JSONObject option=jsonObject.getJSONObject("option");
            String funName=jsonObject.getString('funName');
            switch(type){
              case 'abc':
                 break;
              case 'bcd':
                 Object obj=....
                 ....
                 dispathMessage(funName,obj,'success')
                 break;
            }
        } catch (JSONException e) {
            e.printStackTrace();
            if(!TextUtils.isEmpt(type)){
              dispathMessage(funName,null,'fail')
            }
        }
    }
 //真正發(fā)送給js 的方法 loadurl是異步加載所以如果在web為加載完成發(fā)送無效果
    public void dispathMessage(String funName,Object obj,String type){
        if(TextUtils.isEmpt(type))return;
        JSONObject jsonObject = new JSONObject();
        try {
            if(obj!=null)
            jsonObject.put("data",new Gson().toJson(obj));
            jsonObject.put("type",type);
        } catch (JSONException e) {
            e.printStackTrace();
        }
        final String javascriptCommand=String.format(BridgeUtil.JS_HANDLE_MESSAGE_FROM_JAVA, funName,jsonObject.toString());
        if (Thread.currentThread() == Looper.getMainLooper().getThread()) {
            this.loadUrl(javascriptCommand);
        }else{
            ((Activity) getContext()).runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    //此時(shí)已在主線程中,可以更新UI了
                    loadUrl(javascriptCommand);
                }
            });
        }
    }

public class BridgeUtil {
    final static String JS_HANDLE_MESSAGE_FROM_JAVA = "javascript:%s('%s')";
}

js的封裝還沒做但是大體是如上

框架分析

接下來看下github上的一個(gè)JsBridge這個(gè)框架 start約3000+的 他的實(shí)現(xiàn)比較完整

這里寫圖片描述

這是他的具體實(shí)現(xiàn) 代碼不多 其中assets中的js文件是為了注入他的封裝的js代碼 他的交互方式與上面不同具體實(shí)現(xiàn)

這是他封裝的webview
public class BridgeWebView extends WebView implements WebViewJavascriptBridge {

    private final String TAG = "BridgeWebView";

    //加載自己的js文件 ,然后別人的html調(diào)用它的js來傳遞消息
    public static final String toLoadJs = "WebViewJavascriptBridge.js";
     //callId為鍵,記錄回調(diào)的集合
    Map<String, CallBackFunction> responseCallbacks = new HashMap<String, CallBackFunction>();
    //本地注冊(cè)一個(gè)方法名讓js調(diào)用
    Map<String, BridgeHandler> messageHandlers = new HashMap<String, BridgeHandler>();
    BridgeHandler defaultHandler = new DefaultHandler();

    //發(fā)送消息的對(duì)象,因?yàn)閣ebview加載要時(shí)間所有他這里先用隊(duì)里存儲(chǔ)
    private List<Message> startupMessage = new ArrayList<Message>();

    public List<Message> getStartupMessage() {
        return startupMessage;
    }

//發(fā)送消息
private void queueMessage(Message m) {
            //這邊只有只為null的時(shí)候才會(huì)進(jìn)入發(fā)送消息,置為null是在BridgeWebViewClient的onPageFinished中
        if (startupMessage != null) {
            startupMessage.add(m);
        } else {
            dispatchMessage(m);
        }
    }


public class BridgeWebViewClient extends WebViewClient {
    private BridgeWebView webView;

    public BridgeWebViewClient(BridgeWebView webView) {
        this.webView = webView;
    }

    //這就是他處理交互的另一個(gè)方式
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        try {
            url = URLDecoder.decode(url, "UTF-8");
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }

        if (url.startsWith(BridgeUtil.YY_RETURN_DATA)) { // 如果是返回?cái)?shù)據(jù)
            webView.handlerReturnData(url);
            return true;
        } else if (url.startsWith(BridgeUtil.YY_OVERRIDE_SCHEMA)) { //
            webView.flushMessageQueue();
            return true;
        } else {
            return super.shouldOverrideUrlLoading(view, url);
        }
    }

    @Override
    public void onPageStarted(WebView view, String url, Bitmap favicon) {
        super.onPageStarted(view, url, favicon);
    }

    //這里是是webview加載完成做到的操作
    @Override
    public void onPageFinished(WebView view, String url) {
        super.onPageFinished(view, url);

        if (BridgeWebView.toLoadJs != null) {
            //在當(dāng)前webview中加載一段自己的js文件
            BridgeUtil.webViewLoadLocalJs(view, BridgeWebView.toLoadJs);
        }

        //
        if (webView.getStartupMessage() != null) {
            for (Message m : webView.getStartupMessage()) {
                webView.dispatchMessage(m);
            }
            //這個(gè)里webview加載完成將隊(duì)列之為null 之后就會(huì)走dispatchMessage這個(gè)方法
            webView.setStartupMessage(null);
        }
    }

    @Override
    public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {
        super.onReceivedError(view, errorCode, description, failingUrl);
    }
}

我們觀察的他的封裝對(duì)象和交互方式

public class Message {
    //每個(gè)message都有一個(gè)callbackid 傳遞給js ,js吧這個(gè)返回給客戶端然后客戶端在responseCallbacks中查找返回id的方法
    private String callbackId; //callbackId
    //回復(fù)id
    private String responseId; //responseId
    private String responseData; //responseData
    private String data; //data of message
    private String handlerName; //name of handler
}

BridgeUtil 對(duì)象封裝了js與android之間的數(shù)據(jù)傳遞格式根據(jù)format 處理后做相應(yīng)的操作

他的交互方式放在了BridgeWebViewClient的shouldOverrideUrlLoading 這個(gè)方法

shouldOverrideUrlLoading是當(dāng)網(wǎng)頁的超鏈接相應(yīng)是回調(diào)到WebClinet的shouldOverrideUrlLoading方法中return true本地處理
false是調(diào)整相應(yīng)的鏈接

然后我們看他的js代碼

我們直接看他發(fā)送消息的代碼
 //sendMessage add message, 觸發(fā)native處理 sendMessage
    function _doSend(message, responseCallback) {
        if (responseCallback) {
            var callbackId = 'cb_' + (uniqueId++) + '_' + new Date().getTime();
            responseCallbacks[callbackId] = responseCallback;
            message.callbackId = callbackId;
        }

        //這就是message隊(duì)列 隊(duì)列的原因后面會(huì)將
        sendMessageQueue.push(message);
        //這個(gè)messagingIframe.src 設(shè)置這一串東西
        messagingIframe.src = CUSTOM_PROTOCOL_SCHEME + '://' + QUEUE_HAS_MESSAGE;
    }


//messagingIframe 是iframe元素 添加到element中設(shè)置為不可見 然后在發(fā)送數(shù)據(jù)中設(shè)置src
   function _createQueueReadyIframe(doc) {
        messagingIframe = doc.createElement('iframe');
        messagingIframe.style.display = 'none';
        doc.documentElement.appendChild(messagingIframe);
    }

//在iframe的src屬性設(shè)置url webviewclient中的對(duì)url進(jìn)行攔截做處理
   public boolean shouldOverrideUrlLoading(WebView view, String url) {
        try {
            url = URLDecoder.decode(url, "UTF-8");
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }

        if (url.startsWith(BridgeUtil.YY_RETURN_DATA)) { // 如果是返回?cái)?shù)據(jù)
            webView.handlerReturnData(url);
            return true;
        } else if (url.startsWith(BridgeUtil.YY_OVERRIDE_SCHEMA)) { //
            webView.flushMessageQueue();
            return true;
        } else {
            return super.shouldOverrideUrlLoading(view, url);
        }
    }

_doSent發(fā)送的方法里面的src的內(nèi)容最終會(huì)進(jìn)入 webView.flushMessageQueue(); 因?yàn)樽址ヅ涞脑?/p>


 //這里的_fetchQueue就是js中的_fetchQueue方法 實(shí)際調(diào)用了那個(gè)方法
    final static String JS_FETCH_QUEUE_FROM_JAVA = "javascript:WebViewJavascriptBridge._fetchQueue();";
void flushMessageQueue() {
        if (Thread.currentThread() == Looper.getMainLooper().getThread()) {
            loadUrl(BridgeUtil.JS_FETCH_QUEUE_FROM_JAVA, new CallBackFunction() {

                @Override
                public void onCallBack(String data) {
                    // deserializeMessage
                    //js發(fā)送過來的數(shù)據(jù)分離出來相應(yīng)的去處理
                    List<Message> list = null;
                    try {
                        list = Message.toArrayList(data);
                    } catch (Exception e) {
                        e.printStackTrace();
                        return;
                    }
                    if (list == null || list.size() == 0) {
                        return;
                    }
                    for (int i = 0; i < list.size(); i++) {
                        Message m = list.get(i);
                        String responseId = m.getResponseId();
                        // 是否是response
                        if (!TextUtils.isEmpty(responseId)) {
                            CallBackFunction function = responseCallbacks.get(responseId);
                            String responseData = m.getResponseData();
                            function.onCallBack(responseData);
                            responseCallbacks.remove(responseId);
                        } else {
                            CallBackFunction responseFunction = null;
                            // if had callbackId
                            final String callbackId = m.getCallbackId();
                            if (!TextUtils.isEmpty(callbackId)) {
                                responseFunction = new CallBackFunction() {
                                    @Override
                                    public void onCallBack(String data) {
                                        Message responseMsg = new Message();
                                        responseMsg.setResponseId(callbackId);
                                        responseMsg.setResponseData(data);
                                        queueMessage(responseMsg);
                                    }
                                };
                            } else {
                                responseFunction = new CallBackFunction() {
                                    @Override
                                    public void onCallBack(String data) {
                                        // do nothing
                                    }
                                };
                            }
                            BridgeHandler handler;
                            if (!TextUtils.isEmpty(m.getHandlerName())) {
                                handler = messageHandlers.get(m.getHandlerName());
                            } else {
                                handler = defaultHandler;
                            }
                            if (handler != null){
                                handler.handler(m.getData(), responseFunction);
                            }
                        }
                    }
                }
            });
        }
    }

 function _fetchQueue() {
        //將之前的message都序列出來一次發(fā)送到客戶端
        var messageQueueString = JSON.stringify(sendMessageQueue);
        sendMessageQueue = [];
        //android can't read directly the return data, so we can reload iframe src to communicate with java
        messagingIframe.src = CUSTOM_PROTOCOL_SCHEME + '://return/_fetchQueue/' + encodeURIComponent(messageQueueString);
    }

    //將callback放到responseCallbacks
    public void loadUrl(String jsUrl, CallBackFunction returnCallback) {
        this.loadUrl(jsUrl);
        responseCallbacks.put(BridgeUtil.parseFunctionName(jsUrl), returnCallback);
    }
至于android 調(diào)用js代碼
//message中已經(jīng)包含了方法名
final static String JS_HANDLE_MESSAGE_FROM_JAVA = "javascript:WebViewJavascriptBridge._handleMessageFromNative('%s');";
void dispatchMessage(Message m) {
        String messageJson = m.toJson();
        //escape special characters for json string
        messageJson = messageJson.replaceAll("(\\\\)([^utrn])", "\\\\\\\\$1$2");
        messageJson = messageJson.replaceAll("(?<=[^\\\\])(\")", "\\\\\"");
        String javascriptCommand = String.format(BridgeUtil.JS_HANDLE_MESSAGE_FROM_JAVA, messageJson);
        if (Thread.currentThread() == Looper.getMainLooper().getThread()) {
            this.loadUrl(javascriptCommand);
        }
    }

查看js中


    //提供給native調(diào)用,receiveMessageQueue 在會(huì)在頁面加載完后賦值為null,所以
    function _handleMessageFromNative(messageJSON) {
        console.log(messageJSON);
        if (receiveMessageQueue && receiveMessageQueue.length > 0) {
            receiveMessageQueue.push(messageJSON);
        } else {
            _dispatchMessageFromNative(messageJSON);
        }
    }

/提供給native使用,
    function _dispatchMessageFromNative(messageJSON) {
        setTimeout(function() {
            //解析message
            var message = JSON.parse(messageJSON);
            var responseCallback;
            //java call finished, now need to call js callback function
            if (message.responseId) {
                responseCallback = responseCallbacks[message.responseId];
                if (!responseCallback) {
                    return;
                }
                responseCallback(message.responseData);
                delete responseCallbacks[message.responseId];
            } else {
                //直接發(fā)送
                if (message.callbackId) {
                    var callbackResponseId = message.callbackId;
                    responseCallback = function(responseData) {
                        _doSend({
                            responseId: callbackResponseId,
                            responseData: responseData
                        });
                    };
                }
                 
                var handler = WebViewJavascriptBridge._messageHandler;
                if (message.handlerName) {
                    //根據(jù)message中方法名去messageHandlers中去找,messageHandlers是js中注冊(cè)了的function集合
                    handler = messageHandlers[message.handlerName];
                }
                //查找指定handler
                try {
                    handler(message.data, responseCallback);
                } catch (exception) {
                    if (typeof console != 'undefined') {
                        console.log("WebViewJavascriptBridge: WARNING: javascript handler threw.", message, exception);
                    }
                }
            }
        });
    }

android 調(diào)試js代碼

之前代碼中有一段

 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            setWebContentsDebuggingEnabled(true);
        }

開啟后 在chrome瀏覽器中 輸入chrome://inspect 然后能找到當(dāng)前應(yīng)用有個(gè)insert按鈕

這里寫圖片描述

然后就可以開始搞事了
以上是jsbridge具體實(shí)現(xiàn)的思路

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

推薦閱讀更多精彩內(nèi)容

  • Android 自定義View的各種姿勢(shì)1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 173,301評(píng)論 25 708
  • 前言 總結(jié) Android WebView 常用的相關(guān)知識(shí)點(diǎn),令包含以下干貨內(nèi)容分析:Js注入漏洞、WebView...
    無名小子的雜貨鋪閱讀 69,883評(píng)論 17 169
  • 隨著H5性能的提升,在我們移動(dòng)應(yīng)用開發(fā)的過程中,我們會(huì)越來越多的在我們的App頁面內(nèi)嵌入H5頁面,使得App變的更...
    Jensen95閱讀 4,242評(píng)論 0 21
  • webview 與 JS 交互分為兩種: Android & iOS 調(diào)用 JS 的方法 JS 調(diào)用 Androi...
    zhuhf閱讀 15,021評(píng)論 17 84
  • 人只有在失去之后才會(huì)懂得珍惜,一直以來都是活在自己的世界里無法自拔。不想理會(huì)任何事,任何人。其實(shí)是在逃避,不敢面對(duì)...
    權(quán)志龍你好啊閱讀 210評(píng)論 0 0