DSBridge

DSBridge is currently the best Javascript bridge in the world , by which we can call functions synchronously and asynchronously between web and Native . Moreover, both android and ios are supported !

DSBridge-IOS:https://github.com/wendux/DSBridge-IOS

DSBridge-Android:https://github.com/wendux/DSBridge-Android

2.0更新列表：https://juejin.im/post/593fa055128fe1006aff700a

中文文档：https://github.com/wendux/DSBridge-Android/blob/master/readme-chs.md

Download

Add the JitPack repository to your build file

allprojects {
  repositories {
   ...
   maven { url 'https://jitpack.io' }
  }
}

Add the dependency

dependencies {
	compile 'com.github.wendux:DSBridge-Android:2.0-SNAPSHOT'

	// support  the x5 browser core of tencent
	// compile 'com.github.wendux:DSBridge-Android:x5-SNAPSHOT'

	//compile 'com.github.wendux:DSBridge-Android:master-SNAPSHOT'
}

Usage

Implement apis in Java

public class JsApi{
    //for synchronous invocation
    @JavascriptInterface
    String testSyn(JSONObject jsonObject) throws JSONException {
        // The return value type can only be  String
        return jsonObject.getString("msg") + "［syn call］";
    }
    //for asynchronous invocation
    @JavascriptInterface
    void testAsyn(JSONObject jsonObject, CompletionHandler handler) throws JSONException {
        handler.complete(jsonObject.getString("msg")+" [asyn call]");
    }
}

For security reason, Java api must be with "@JavascriptInterface" annotation, For more detail about this topic, please google .

Setup api class to DWebView instance.

import wendu.dsbridge.DWebView
...
DWebView dwebView= (DWebView) findViewById(R.id.dwebview);
dwebView.setJavascriptInterface(new JsApi());

Call Java api in Javascript, and declare a global javascript function for the following java invocation.

Init dsBridge

//cdn
//<script src="https://unpkg.com/dsbridge/dist/dsbridge.js"> </script>
//npm
//npm install dsbridge
var dsBridge=require("dsbridge")

Call API

//Call synchronously 
var str=dsBridge.call("testSyn", {msg: "testSyn"});

//Call asynchronously
dsBridge.call("testAsyn", {msg: "testAsyn"}, function (v) {
  alert(v);
})
//Register javascript function for Native invocation
 dsBridge.register('addValue',function(l,r){
     return l+r;
 })

Call Javascript function in java

webView.callHandler("addValue",new Object[]{1,"hello"},new OnReturnValue(){
       @Override
       public void onValue(String retValue) {
          Log.d("jsbridge","call succeed,return value is "+retValue);
       }
});

Notice: Be sure that calling javascript functions must at "PageFinished".

Javascript API introduction

dsBridge

"dsBridge" is available after dsBridge Initialization , it has two method "call" and "register";

bridge.call(method,[args,callback])

Call Java api synchronously and asynchronously。

method: Java method name

args: arguments with json object

callback(String returnValue):callback to handle the result. only asynchronous invocation required.

dsBridge.register(methodName,function)

methodName: javascript function name

function: javascript method body.

Notice

Java api signature

In order to be compatible with IOS and Android, we make the following convention on native api signature:

The tye of return value must be String; if not need, just return null.
The arguments passed by JSONObject, if the api doesn't need argument, you still need declare the jsonObject argument.

More about DWebview

In DWebview, the following functions will execute in main thread automatically, you need not to switch thread by yourself.

void loadUrl( String url) 
void loadUrl(final String url, Map<String, String> additionalHttpHeaders)
void evaluateJavascript(String script)

alert/confirm/prompt dialog

For alert/confirm/prompt dialog, DSBridge has implemented them all by default, if you want to custom them, override the corresponding callback in WebChromeClient class.

Finally

If you like DSBridge, please star to let more people know it , Thank you 😄.

edensummer/DSBridge-Android