Android的WebView与H5前端JS代码交互的实例代码

发布时间 - 2026-01-11 02:33:55    点击率:

前段时间项目有深度和前端对接过,也是碰了一些坑,现在有时间就拿出来分享下

JS调用原生不外乎就两种,一种是传假的url,也就是url拦截的方式,类似于下面这种:

//js代码
 function sendCommand(param){
  var url="js-call://"+param;
  document.location = url;
 }
 sendCommand("PlaySnake");

//Java代码
 mWebView.setWebViewClient(new WebViewClient() {
   @Override
   public boolean shouldOverrideUrlLoading(WebView view, String url) {
     if (url.contains("js-call:")) {
       if (url.contains("PlaySnake")) {
        Log.d("X5WebViewActivity", "玩蛇");
       } else if (url.contains("WhatDoesTheFoxSay")) {
        Log.d("X5WebViewActivity", "叮铃铃铃叮铃铃");
       } else {
        showInfoAsToast("龟儿娃,你调得不对");
       }
       return false;
     }
     view.loadUrl(url);
     return true;    
   }
 });

这种方法来调用原生,好处就是集成比较迅速,约定一个标识,类似于示例中的“js-call”,再约定一波Type,比如“玩蛇”之类的,代码很简单,毕竟大家都很忙。

但是如果你打算长期把这个项目做下去的话,这种方式还是不要了吧,缺点太明显了。首先是给原生传数据,只能是字符串;然后业务扩展起来,你的else if越写越多,里面再加一大把switch,代码越来臃肿,维护起来那感觉真的酸爽。

另一种就是通过谷歌提供的JS与Java绑定的接口,约定好要交互的对象名,类似于下面的“App”

//通过WebView提供的addJavascriptInterface这行代码,我们在浏览器的JS环境中创建了一个"App"对象
//这个对象下的函数就是自定义接口类里面通过 @JavascriptInterface注解的Java方法转换而来的

mWebView.addJavascriptInterface(new JavaFuckJSInterface(this), "App");

/**
 * 自定义的交互接口类
 */
public class JavaFuckJSInterface{
  private WeakReference<X5WebViewActivity> x5WebViewActivity;

  public JavaFuckJSInterface(X5WebViewActivity context) {
    x5WebViewActivity = new WeakReference<>(context);
  }
  //通过这个@JavascriptInterface转化成绑定的“App”对象下的同名函数,js代码可以直接调用
  @JavascriptInterface
  public void presentCamera(String data) {
    //拍照上传
    x5WebViewActivity.get().presentCamera(data);
  }
}


//js代码
 var parameter = {};
 parameter.size = "1024*768";
 parameter.format = "JPEG";
 var parameterStr = JSON.stringify(parameter);
 App.presentCamera(parameterStr);

这样写的话,规范了不少,即使函数再多,这个接口里面也是一目了然,调函数就是调函数,传参数就是传参数,相比于之前那个方法,可读性高了不少

不过上面写的这些破玩意网上资料一大把,我特么是吃多了么,再写一遍?

NoNoNo,这些东西确实足够我们与JS交互了,但是前端不想搞JSON.stringify(parameter)这种操作啊,他要直接传对象过来。为什么别人IOS都可以拿到我的对象,你拿的就是undefined?为什么别人IOS能给我对象,你就不给我对象,偏要给我字符串?凭什么别人IOS能拿到我的匿名回调函数来调用,你偏偏让我写一个回调函数给你调?

ok,也不是不能做到,不过这就需要通过注入JS代码来完成了

talk is cheap , show me the code

下面这个微型的SDK能够实现互调传JSON对象,调用js传入的匿名函数

 //需要注入的js代码,加//"是因为简书会忽略\"这个回引号,不加的话后面的代码都是字符串的颜色了

 //原理是通过这个SDKNativeEvents来保存传入的匿名函数callback,等原生做完该做的操作之后
 //接着去调用sdk_nativeCallback这个函数来运行存进去的callback
 var SDKNativeEvents = {}
 function sdk_launchFunc(funcName,data,callback){
   if(!data){
     alert(\"必须传入data\");//"
     return;
   }
   if(!callback){
     alert(\"必须传入回调function\");//"
     return;
   }
   SDKNativeEvents[funcName] = callback;
   var jsObj={};
   jsObj.funcName=funcName;
   jsObj.data=JSON.stringify(data);
   var str = JSON.stringify(jsObj);
   App.native_launchFunc(str) //这个函数要在JavascriptInterface里申明
 }
 function sdk_nativeCallback(funcName,data){
   var obj= JSON.parse(data);
   if(SDKNativeEvents[funcName]){
     SDKNativeEvents[funcName](obj);
     if(funcName != \"updateLocation\"){//定位回调会不定时去重复触发,不做置空操作"
       SDKNativeEvents[funcName] = null;
     }
   }
 }
 //下面实现的功能和通过@JavascriptInterface注解的Java方法是一样的,App为约定好的注入对象名
 //App.xxx为暴露给前端的js函数
 App.login = function(data,callback){
   sdk_launchFunc(\"login\",data,callback);//"
 }
 App.xxxxxxxxxxxxx = function(data,callback){
   sdk_launchFunc(\"xxxxxxxxxxxxx\",data,callback);//"
 }
 ...

上面那些App.xxx的函数其实也可以不用注入,实现起来就是把 sdk_launchFunc这个函数注入到App对象下面,让前端直接调用,这样不用增加一个调用就多注入一个函数,前端只用改funcName就能实现所有的调用。但是我觉得,调函数就是调函数,传参数就是传参数,将每个功能拆成function可以提高代码的可读性

注入JS代码也很简单,把上面那些js代码都粘贴到string这个资源文件里面,再通过mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code1))来注入就行,其中js_sdk_code1就是js代码的字符串

示例代码:

//在网页加载时提前注入,可以保证页面一旦加载完毕前端就能立即调到函数
 mWebView.setWebChromeClient(new WebChromeClient() {
      @Override
      public void onProgressChanged(WebView webView, int i) {
        super.onProgressChanged(webView, i);
        if (i >= 10 && canInject) {
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code1));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code2));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code3));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code4));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code5));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code6));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code7));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code8));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code9));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code10));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code11));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code12));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code13));
          mWebView.loadUrl("javascript:" + getString(R.string.js_sdk_code14));
          canInject = false;
        }
        if (i == 100) {
          canInject = true;
        }
     }
});

这个时候有人就要问了,怎么注入这么多次,我也不想啊,这里有个坑的,一次注入的代码超过三行左右(分号结束为一行)吧,就会有几率出现注入失败,会造成所有js代码都没法注入进去,我就干脆直接一次注入一行代码来跳出这个坑,比如下面的js_sdk_code3就可以注入,虽然这个function内部有好几行代码,但是整体来说也算一行代码,这行代码定义了这个function。然而我又试了,在这个function里面再多加一行代码就会注入失败,搞得现在我也不确定他失败的零界点在哪里,反正尽量拆开注入吧。

将要注入的js代码拆开注入

细心的同学已经发现了,搞了这么多花里胡哨的,最关键的原生怎么来响应js的调用还没说明,别急,下面上代码

  //@JavascriptInterface的代码应该放在哪里不用我讲了吧
  //通过与js交互的接口类来拿到做什么事,以及传过来的JSON对象转成的字符串
  @JavascriptInterface
  public void native_launchFunc(String data) {
    try {
      JSONObject jsonObject = new JSONObject(data);
      String funcName = jsonObject.getString("funcName");
      String dataStr = jsonObject.getString("data");
      switchName(funcName, dataStr);
    } catch (JSONException e) {
      e.printStackTrace();
    }
  }
  
  private void switchName(String funcName, String dataStr) {
    if (funcName == null) {
      return;
    }
    switch (funcName) {
      case "login":
        x5WebViewActivity.get().login(data);
        break;
      case "xxx":
        x5WebViewActivity.get().xxx(data);
        break;
    }
  }

   //这里演示调用了login让原生来登陆,等登陆成功之后,我们去调用js的匿名回调,并传入token
   JsonObject jsonObject = new JsonObject();
   jsonObject.addProperty("token", PreferencesHelper.getInstance().getToken());
   String js = "javascript:sdk_nativeCallback(\'login\',\'" + jsonObject + "\')";
   mWebView.loadUrl(js);

Android原生调用JS代码也有两种,一种是通过上面的loadUrl,一种是下面这种:

  String script = "sdk_nativeCallback(\'login\',\'" + jsonObject + "\')";
  mWebView.evaluateJavascript(script, responseJson -> {
     if (!TextUtils.isEmpty(responseJson)) {
       //拿到js函数的返回值
     }
 });

区别就是一个能拿到js函数的返回值,一个拿不到,这个根据自己的需求来选用

前端js调用原生传入匿名回调的示例代码:

//js代码
 var fucker = {};
 fucker.name = "pdd";
 fucker.age = 18;
 App.login(fucker, function (data) {
    if (data.err) {
     alert(data.err);
    }
    alert(data.token);
 });

我们可以看到,前端给我们传入的是对象和匿名回调函数,匿名回调需要的参数依然是个对象,我们通过注入的SDK保存了这个回调函数,并自己做了对象和字符串转换,实际上Java代码最终拿到和传出去还都是字符串,我们通过这个sdk统一的进行了转换,前端js代码那边不用判断手机是iPhone或者是Android,统一发出和接受对象,传入回调函数,能够减少他们很多工作量。

对了,因为Android版本不一致,webview的兼容性参差不齐,选用了腾讯的X5内核浏览器来加载,其中有个坑就是全屏播放视频会有qq浏览器的广告,这个可以通过代码去掉,也拿出来分享下吧:

 //去掉QQ浏览器广告
 private void removeTbsAd() {
  getWindow().getDecorView().addOnLayoutChangeListener
      ((v, left, top, right, bottom, oldLeft, oldTop, oldRight, oldBottom) -> {
        ArrayList<View> outView = new ArrayList<>();
        View decorView = getWindow().getDecorView();
        decorView.findViewsWithText(outView, "相关视频", View.FIND_VIEWS_WITH_TEXT);
        decorView.findViewsWithText(outView, "QQ浏览器", View.FIND_VIEWS_WITH_TEXT);
        if (outView.size() > 0) {
          outView.get(0).setVisibility(View.GONE);
        }
      });
 }

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。


# android  # webview  # h5  # Android与H5交互  # 与js交互  # Android实现H5与Native交互的两种方式  # Android webview加载H5方法详细介绍  # Android Studio打包H5网址页面  # 封装成APK  # 移动端H5唤起APP的写法实例(IOS、android)  # Android与H5交互产生Script Error踩坑解决  # 回调  # 都是  # 类似于  # 给我  # 有个  # 就能  # 两种  # 加载  # 自定义  # 再多  # 绑定  # 能拿到  # 这行  # 自己的  # 返回值  # 的是  # 铃铃  # 我也  # 直接调用  # 我就 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 美食网站链接制作教程视频,哪个教做美食的网站比较专业点?  如何用花生壳三步快速搭建专属网站?  如何在 React 中条件性地遍历数组并渲染元素  JavaScript如何实现错误处理_try...catch如何捕获异常?  软银砸40亿美元收购DigitalBridge 强化AI资料中心布局  Laravel如何获取当前登录用户信息_Laravel Auth门面使用与Session用户读取【技巧】  Laravel如何使用Scope本地作用域_Laravel模型常用查询逻辑封装技巧【手册】  bootstrap日历插件datetimepicker使用方法  移动端手机网站制作软件,掌上时代,移动端网站的谷歌SEO该如何做?  香港网站服务器数量如何影响SEO优化效果?  简历在线制作网站免费版,如何创建个人简历?  实例解析angularjs的filter过滤器  Bootstrap整体框架之JavaScript插件架构  JavaScript实现Fly Bird小游戏  Laravel如何与Inertia.js和Vue/React构建现代单页应用  Laravel用户认证怎么做_Laravel Breeze脚手架快速实现登录注册功能  宙斯浏览器视频悬浮窗怎么开启 边看视频边操作其他应用教程  html5的keygen标签为什么废弃_替代方案说明【解答】  晋江文学城电脑版官网 晋江文学城网页版直接进入  什么是JavaScript解构赋值_解构赋值有哪些实用技巧  如何在 Go 中优雅地映射具有动态字段的 JSON 对象到结构体  iOS UIView常见属性方法小结  如何在Windows 2008云服务器安全搭建网站?  安克发布新款氮化镓充电宝:体积缩小 30%,支持 200W 输出  Laravel如何实现API速率限制?(Rate Limiting教程)  胶州企业网站制作公司,青岛石头网络科技有限公司怎么样?  装修招标网站设计制作流程,装修招标流程?  Android 常见的图片加载框架详细介绍  php后缀怎么变mp4格式错误_修改扩展名提示格式不对怎么办【技巧】  Laravel中间件如何使用_Laravel自定义中间件实现权限控制  如何快速搭建FTP站点实现文件共享?  Laravel如何与Pusher实现实时通信?(WebSocket示例)  大连 网站制作,大连天途有线官网?  如何挑选优质建站一级代理提升网站排名?  Laravel如何为API生成Swagger或OpenAPI文档  lovemo网页版地址 lovemo官网手机登录  Laravel的.env文件有什么用_Laravel环境变量配置与管理详解  长沙企业网站制作哪家好,长沙水业集团官方网站?  如何构建满足综合性能需求的优质建站方案?  Laravel的路由模型绑定怎么用_Laravel Route Model Binding简化控制器逻辑  Midjourney怎样加参数调细节_Midjourney参数调整技巧【指南】  Laravel的Blade指令怎么自定义_创建你自己的Laravel Blade Directives  如何快速搭建高效WAP手机网站?  Laravel观察者模式如何使用_Laravel Model Observer配置  EditPlus中的正则表达式 实战(1)  Python面向对象测试方法_mock解析【教程】  如何在万网主机上快速搭建网站?  Laravel Eloquent模型如何创建_Laravel ORM基础之Model创建与使用教程  Laravel广播系统如何实现实时通信_Laravel Reverb与WebSockets实战教程  如何用5美元大硬盘VPS安全高效搭建个人网站?