Js和原生相互调用总结

# 前端 2024-04-03 04:50 0 17 来源：数据天堂

一、前言

　　现在市面上有一些app是通过原生ios、Android加载一个网页实现的，如图所示，这样的app我们称之为 Hybrid App

　　　　那么为什么要用 hybrid app呢？个人认为的原因有两点：1.提高开发效率，以钉钉为例在涉及到一些OA操作比如打卡，请假等功能的时候，显然一个嵌入一个网页就能够满足需求，如果在让IOS和Android再去各自开发一套那么效率就很低了。2.提高迭代效率。以商城为例，商城页面会根据市场情况实时发生变化，比如遇到各种节假日活动做促销。那么这个时候如果用原生，那么迭代等用户去升级可能这个活动都已经过了，但是用嵌套webview嵌套一个网页只需要网页做出修改hybrid app内的web页面就会马上修改，这样效率就非常高了。　　　　

　　　　hybrid app 实际上就是利用原生的组件webview加载一个url再让js和原生相互调用实现各种功能，那么接下来我就把js和原生相互调用的情况做一个总结。

二、原生api实现：js和原生相互调用

　　要想让js和原生相互调用，对于webview最基本的一个设置就是要允许js脚本执行

 WebSettings settings = mWebView.getSettings(); settings.setJavaScriptEnabled(true);

（一）、js调用原生

　　假设我现在有一个需求：点击web中的一个按钮，将web中的值传递给原生并在TextView组件中显示出来。那么这个需求怎么实现呢？

　　第一步：在java代码中定义js要调用的方法

　　// 定义JS需要调用的方法
 // 被JS调用的方法必须加入@JavascriptInterface注解
 @JavascriptInterface
 public void sendMsg(String msg) {
// Log.i(TAG, "JS调用了Android的hello方法" + msg);
// Toast.makeText(mContext, "JS调用了Android的hello方法" + msg, Toast.LENGTH_SHORT).show();
 //为了方便拿到上下文和ui组件,写一个回调接口。
 mJSBridge.sendMsg(msg);
 }

　　这里需要说明的是，1.要在方法上面添加“@JavascriptInterface”注解，2.定义的方法必须是公共方法

　　第二步：给webview添加js脚本接口。

 mWebView.addJavascriptInterface(jsInterface, "Android_Interface");

　　void addJavascriptInterface (Object object, String name)，这个方法有两个参数，第一个是一个注入webview中js上下文的java对象，第二个参数是在js脚本中来暴露的名称对象，也就是说，这里写什么，待会在js调用原生的时候就写什么。

　　第三步：用js调用原生方法

function sendMsg() { Android_Interface.sendMsg("你好,这是要传递的参数")}

（二）、原生调用js

　　原生调用js中的方法，例如，在这里我们实现点击原生中的按钮来改变web中div的样式。那么这个该如何实现呢？

　　这里直接使用webview的api就能够实现。Android中的代码如下：　

 // 第一种调用js中代码的方法// mWebView.loadUrl("javascript:beStronger()"); //第二种调用js中代码的方法,同时传值过去 mWebView.evaluateJavascript("javascript:beStronger(‘" + str + "‘)", new ValueCallback<String>() { @Override public void onReceiveValue(String value) { //此处为 js 返回的结果 Toast.makeText(H5Activity.this, value, Toast.LENGTH_SHORT).show(); } });

　　在web中的代码如下：

function beStronger(value) { let box = document.getElementById("box"); // box.innerText = value; box.className = "box2"; box.innerText=value; return "小明你好"
}

　　当点击原生按钮web中的div就会发生变化。

（三）、可能存在的安全性问题

　　但是在js调用原生的时候，可能会存在安全问题。具体的产生原因和解决办法可以参考这一篇文章。《你不知道的 Android WebView 使用漏洞》。那如果要做的app对安全性要求极高，该怎么办呢？这里推荐一个Android的第三方库：JSBridge

三、第三方库实现：js和原生相互调用

　　关于这个第三方库的介绍，在说明文件中已经说得很清楚了：该库是js和java相互调用的桥梁，它为js和java之间相互调用提供了一个安全且便捷的方法。

（一）、引入第三方库

　　第一步是在 app/build.gradle 文件中引入该库。

 repositories { // ... maven { url "https://jitpack.io" } }dependencies { ..... compile ‘com.github.lzyzsd:jsbridge:1.0.4‘}

　　然后在布局中添加自定义的组件，BridgeWebView，该组件继承自原生的WebView组件。

 <!-- webview 演示web调用Java --> <com.github.lzyzsd.jsbridge.BridgeWebView android:id="@+id/webView" android:layout_width="match_parent" android:layout_height="match_parent"> </com.github.lzyzsd.jsbridge.BridgeWebView>

（二）、js调用原生

　　这套框架使用的核心就是：handler的注册的调用。

　　要先实现js调用原生，那么首先要在java原生中“注册handler”，代码如下

//注册handler
webView.registerHandler("submitFromWeb", new BridgeHandler() { @Override public void handler(String data, CallBackFunction function) { Log.i(TAG, "handler = submitFromWeb, data from web = " + data); function.onCallBack("submitFromWeb exe, response data from Java"); } });

　　在注册了handler以后，就可以在js代码中调用指定的handler了，例如上面我们注册的handler是“submitFromWeb”，js 可以通过如下的方式调用java中注册的handler。

 WebViewJavascriptBridge.callHandler( ‘submitFromWeb‘ , {‘param‘: str1} , function(responseData) { document.getElementById("show").innerHTML = "send get responseData from java, data = " + responseData } );

（三）、原生调用js

　　要先实现原生调用js，那么首先也要在js中注册handler

 WebViewJavascriptBridge.registerHandler("functionInJs", function(data, responseCallback) { document.getElementById("show").innerHTML = ("data from Java: = " + data); var responseData = "Javascript Says Right back aka!"; responseCallback(responseData); });

　　在js中注册了handler以后，在java代码中就能够调用指定名称的handler　

 webView.callHandler("functionInJs", new Gson().toJson(user), new CallBackFunction() { @Override public void onCallBack(String data) { } });

（四）、需要注意的地方

　　这个库将注册一个 WebViewJavascriptBridge 对象给window 对象。那么在你的js代码中，在使用WebViewJavascriptBridge对象之前，你必须检测WebViewJavascriptBridge对象是否存在。如果WebViewJavascriptBridge对象不存在，你可以监听WebViewJavascriptBridgeReady事件，如下所示：

 if (window.WebViewJavascriptBridge) { //do your work here } else { document.addEventListener( ‘WebViewJavascriptBridgeReady‘ , function() { //do your work here }, false ); }