JsBridge
Introduction: 基于 github.com/lzyzsd/JsBridge 优化改进而来的 JsBridge
Tags:
JsBridge 库现已迁移至 Jitpack,具体使用如下:
1.工程根 build.gradle 添加 jitpack
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
2.模块 build.gradle 添加依赖
dependencies {
implementation 'com.github.hjhrq1991:JsBridge:1.1.1'
}
本项目共有两个部分: 1.基于系统的 JsBridge; 2.基于 Tbs X5 内核的 JsBridge;
基于https://github.com/lzyzsd/JsBridge 优化改进而来的 Android JsBridge
优化
1.支持自定义桥名;
2.修复 web 页未渲染即进行跳转导致 Js 桥初始化失败的问题;
使用
添加 maven 依赖
<dependency>
<groupId>com.hjhrq1991.library</groupId>
<artifactId>jsbridge</artifactId>
<version>1.1.0</version>
<type>pom</type>
</dependency>
添加 gradle 依赖
compile 'com.hjhrq1991.library:jsbridge:1.1.0'
在你的布局上添加 BridgeWebView
<com.hjhrq1991.library.BridgeWebView
android:id="@+id/webView"
android:layout_width="match_parent"
android:layout_height="match_parent" />
使用默认桥名或自定义桥名
//description:如需使用自定义桥名,调用以下方法即可,
// 传空或不调用 setCustom 方法即使用默认桥名。
// 默认桥名:WebViewJavascriptBridge
webView.setCustom("TestJavascriptBridge");
Android 上使用方法
注册一个 handler 方法供 Js 调用
webView.registerHandler("initSignNetPay", new BridgeHandler() {
@Override
public void handler(String data, CallBackFunction function) {
Log.i(TAG, "回传结果:" + data);
Toast.makeText(MainActivity.this, data, Toast.LENGTH_SHORT).show();
}
});
Java 里调用 Js 里的 handler 方法
webView.callHandler("click1", "success", new CallBackFunction() {
@Override
public void onCallBack(String data) {
Log.i(TAG, "回传结果:" + data);
Toast.makeText(MainActivity.this, data, Toast.LENGTH_SHORT).show();
}
});
使用默认 handler 方法来进行交互
webView.setDefaultHandler(new DefaultHandler());
window.WebViewJavascriptBridge.send(
data, function(responseData) {
document.getElementById("show").innerHTML = "repsonseData from java, data = " + responseData
}
);
JavaScript 上使用方法
构建桥连接
var default_data = {
error: "1"
};
var connectMerchantJSBridge = function (callback) {
try {
if (window.WebViewJavascriptBridge) {
callback(WebViewJavascriptBridge);
} else {
document.addEventListener("WebViewJavascriptBridgeReady", function () {
callback(WebViewJavascriptBridge);
}, false);
}
} catch (ex) { }
};
var cmbMerchantBridge = {
initSignNet: function (payData,name) {
if (!payData) {
payData = default_data;
}
connectMerchantJSBridge(function (bridge) {
if (typeof bridge === "undefined") {
return;
}
bridge.callHandler(name, JSON.stringify(payData));
});
},
};
`
调用 Android 上的 handler 方法
function click1(){
var objData = new datas();
var payData = objData.click1;
try {
cmbMerchantBridge.initSignNet(payData, "initSignNetPay");
} catch (ex) { }
}
JavaScript 里注册一个 handler 方法供 Android 调用
/*app native 调用本页面方法*/
connectMerchantJSBridge(function(bridge) {
bridge.init(function(message, responseCallback) {
});
bridge.registerHandler("click1", function(data, responseCallback) {
responseCallback("receive click1");
//可以在下面执行操作
});
})
window.cmbMerchantBridge = cmbMerchantBridge;
setWebViewClient
Js 桥的处理在 WebViewClient 里进行,因此使用 setWebViewClient()方法会导致 Js 桥失效 因此提供新的 API 方法进行回调
webView.setBridgeWebViewClientListener(new SimpleBridgeWebViewClientListener() {
});
当然你也可以直接 new BridgeWebViewClientListener()
webView.setBridgeWebViewClientListener(new BridgeWebViewClientListener() {
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
return false;
}
@Override
public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
return false;
}
@Override
public void onPageStarted(WebView view, String url, Bitmap favicon) {
}
@Override
public void onPageFinished(WebView view, String url) {
}
@Override
public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {
}
@Override
public void onLoadResource(WebView view, String url) {
}
@Override
public WebResourceResponse shouldInterceptRequest(WebView view, String url) {
return null;
}
@Override
public WebResourceResponse shouldInterceptRequest(WebView view, WebResourceRequest request) {
return null;
}
@Override
public boolean onTooManyRedirects(WebView view, Message cancelMsg, Message continueMsg) {
return false;
}
@Override
public boolean onFormResubmission(WebView view, Message dontResend, Message resend) {
return false;
}
@Override
public void doUpdateVisitedHistory(WebView view, String url, boolean isReload) {
}
@Override
public boolean onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) {
return false;
}
@Override
public boolean onReceivedClientCertRequest(WebView view, ClientCertRequest request) {
return false;
}
@Override
public boolean onReceivedHttpAuthRequest(WebView view, HttpAuthHandler handler, String host, String realm) {
return false;
}
@Override
public boolean shouldOverrideKeyEvent(WebView view, KeyEvent event) {
return false;
}
@Override
public boolean onUnhandledKeyEvent(WebView view, KeyEvent event) {
return false;
}
@Override
public void onScaleChanged(WebView view, float oldScale, float newScale) {
}
@Override
public void onReceivedLoginRequest(WebView view, String realm, String account, String args) {
}
@Override
public void onPageCommitVisible(WebView view, String url) {
}
@Override
public boolean onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
return false;
}
@Override
public void onReceivedHttpError(WebView view, WebResourceRequest request, WebResourceResponse errorResponse) {
}
});
混淆
从 1.1.7 版本开始需要增加混淆规则
-keep public class com.hjhrq1991.library.Message{*;}
License
This project is licensed under the terms of the MIT license.
