小程序webview(H5)调用JSSDK功能指北

JavaScript023

小程序webview(H5)调用JSSDK功能指北,第1张

最核心的一个概念 :小程序 的webview(H5页面)中调用jssdk中的功能(比如获取位置信息),需要有一个和小程序申请主体一致的 公众号 账号,在公众号里去配置相关的jssdk信息.1 小程序账号因为webview不支持个人类型,所以需要申请一个企业法人及个体工商户类型的小程序账号2   公众号账号要求小程序和公众号的账号对应的主体信息必须一致,有两种途径达到此目的: 先申请公众号账号,然后通过公众号的快速生成小程序功能,生成步骤1的小程序账号,这样这两个自然满足同主体资格登录微信公众号平台,点击小程序管理-添加-快速注册并认证小程序:用和申请小程序账号完全一致的主体信息去申请公众号(主体类型,主体名称,主体证件号),也能保证两个账号的主体资格一致(目前没有小程序快速生成公众号账号的功能..)3 域名绑定这里需要两个账号都配置一下:业务域名首先webview指向一个外部网页链接(我们的H5页面) <web-view src="https://abc.xxx.com.cn/cc/index.html"></web-view> 这个地址要满足: 已经通过ICP备案域名 https协议 不支持自定义端口 不支持ip地址 不支持短链域名 那么首先要在 小程序 中的'开发'-'开发设置'的'业务域名'中,将https://abc.xxx.com.cn配置进去:JS接口安全域名在上述h5页面中,因为要调用jssdk的js文件: <script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.3.2.js"></script> 因此要在公众号设置”的“功能设置”里填写“JS接口安全域名”注意 :以上两个配置地址时,都需要将配置时提供的一个文本文件按照要求上传到H5页面所在服务器并确保能被访问,用于腾讯验证服务器,否则是无法提交相关信息的4 应用jssdk提供了很多功能,但是webview中,只支持部分接口,自行查看web-view,这里以获取位置信息为例:通过config接口注入权限验证配置所有需要使用JSSDK的页面必须先注入配置信息,否则将无法调用: wx.config({ appId: '', // 必填,公众号的appid,注意不是小程序的appid timestamp: , // 必填,生成签名的时间戳 nonceStr: '', // 必填,生成签名的随机串 signature: '',// 必填,签名 debug: true, // 选填,开启调试模式,调用的所有api的返回值会在客户端alert出来。 jsApiList: ['getLocation'] // 必填,需要使用的JS接口列表,这里为获取位置信息 }) 以上参数除了最后两个,建议在后台服务中存储和计算,具体需参考jssdk,主要思路: 利用公众号的 appid 和 secret 去获取 access_token利用 access_token 去获取 ticket利用ticket和自行生成的( timestamp , nonceStr ,当前页面的 地址 )计算出最终的 签名 执行getLocation以上步骤执行成功后,方可执行wx.getLocation: var success=true // 之所以这里有个success变量,是因为发现wx.error触发也会调用wx.ready(如果有个wx.success就好了) //但其实这并不完美,因为还发现有时候wx.ready先执行,然后触发了wx.error ........ wx.ready(function(){ if(success){ wx.getLocation({ type: 'wgs84', success(res) { // res为坐标位置信息 }, fail(e) { // 获取失败 } }) } // config信息验证后会执行ready方法 }) wx.error(function(res){ success=false // config信息验证失败会执行error函数 }) 吐槽: wx.config有时候成功,有时候说签名失败 wx.ready代表配置验证完毕了,不代表验证成功了,那他的意义在于什么reference: jssdk: https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.htmlweb-view: https://developers.weixin.qq.com/miniprogram/dev/component/web-view.html

移动开发中,我们经常会遇到混合开发模式,经常是在移动客户端中增加网页,来减少客户端的压力,同时也让软件更加灵活。废话少说,下面直接进入主题。

webView.getSettings().setAppCachePath(getCacheDir().getAbsolutePath())

webView.getSettings().setAppCacheEnabled(true)

if (Constant.DEBUG) {

webView.getSettings().setCacheMode(WebSettings.LOAD_NO_CACHE)

}

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {

webView.getSettings().setMixedContentMode(WebSettings.MIXED_CONTENT_ALWAYS_ALLOW)

}

//参数1 定义Android 与js交互的接口, 参数2 与js交互的一个常量,可以是任意一个常量字符串,

但是h5网页调用的时候需要增加这个参数二:handler

public class JSInterface{

@JavascriptInterface//这个标注必须加上 表示js要调用的方法,可以自动识别

public void getShareInfo(String strings) {

//todo android dosomething

}

}

那么 js端该如何调用这个方法呢\

android 和ios的调用方法不一样 因此 h5里面需要区别andorid和ios机型来分别调用移动端方法

如android:

//handler 是与android 约定的常量(最好做成全局通用的常量)

//getShareInfo 是与android 定义的调用方法

以上常量、方法、参数类型 必须一致才能成功调用

WebView提供两个事件回调类给应用层,分别为WebViewClient,WebChromeClient开发者可以继承

这两个类,接手相应事件处理。WebViewClient 主要提供网页加载各个阶段的通知,比如网页开始

加载onPageStarted,网页结束加载onPageFinished等;WebChromeClient主要提供网页加载过程

中提供的数据内容,比如返回网页的title,favicon等。

有需要监听加载网页进度

//需要webBar的可以自定义增加一个webBar

最后,就是大家都知道的webView.loadUrl(url)//url需要加载的网页

那么,如何在android调用js的方法呢

//getMsg() 为js里面暴露的方法

在销毁的时候:

protected void onDestroy() {\

super.onDestroy()\

if (webView != null) {\

webView.loadUrl("about:blank")\

webView.destory()\

}\

}

一、h5 调用 OC,给OC传值

   1、在WKWebview初始化的时候,先注册JS方法

       //这个类主要用来做native与JavaScript的交互管理

       WKUserContentController * wkUController = [[WKUserContentController alloc] init]

        //注册一个name为jsToOcNoPrams的js方法,设置处理接收JS方法的代理

        [wkUController addScriptMessageHandler:self  name:@"jsToOcNoPrams"]

       [wkUController addScriptMessageHandler:self name:@"jsToOcWithPrams"]

        config.userContentController = wkUController

2、拦截js方法,接收参数

注意:遵守WKScriptMessageHandler协议,代理是由WKUserContentControl设置

  //通过接收JS传出消息的name进行捕捉的回调方法

- (void)userContentController:(WKUserContentController *)userContentController didReceiveScriptMessage:(WKScriptMessage *)message{

    NSLog(@"name:%@\\\\n body:%@\\\\n frameInfo:%@\\\\n",message.name,message.body,message.frameInfo)

    //用message.body获得JS传出的参数体

    NSDictionary * parameter = message.body

    //JS调用OC

    if([message.name isEqualToString:@"jsToOcNoPrams"]){

        UIAlertController *alertController = [UIAlertController alertControllerWithTitle:@"js调用到了oc" message:@"不带参数" preferredStyle:UIAlertControllerStyleAlert]

        [alertController addAction:([UIAlertAction actionWithTitle:@"OK" style:UIAlertActionStyleDefault handler:^(UIAlertAction * _Nonnull action) {

        }])]

        [self presentViewController:alertController animated:YES completion:nil]

    }else if([message.name isEqualToString:@"jsToOcWithPrams"]){

        UIAlertController *alertController = [UIAlertController alertControllerWithTitle:@"js调用到了oc" message:parameter[@"params"] preferredStyle:UIAlertControllerStyleAlert]

        [alertController addAction:([UIAlertAction actionWithTitle:@"OK" style:UIAlertActionStyleDefault handler:^(UIAlertAction * _Nonnull action) {

        }])]

        [self presentViewController:alertController animated:YES completion:nil]

    }

}

3、在webview释放注销之前移除js方法

      //移除注册的js方法

        [[_webView configuration].userContentController removeScriptMessageHandlerForName:@"jsToOcNoPrams"]

二、oc调用H5,给H5传值

1、//OC调用JS changeColor()是JS方法名,completionHandler是异步回调block

    NSString *jsString = [NSString stringWithFormat:@"changeColor('%@')", @"Js参数"]

    [_webView evaluateJavaScript:jsString completionHandler:^(id _Nullable data, NSError * _Nullable error) {

        NSLog(@"改变HTML的背景色")

    }]

//改变字体大小 调用原生JS方法

    NSString *jsFont = [NSString stringWithFormat:@"document.getElementsByTagName('body')[0].style.webkitTextSizeAdjust= '%d%%'", arc4random()%99 + 100]

    [_webView evaluateJavaScript:jsFont completionHandler:nil]

2、// 页面加载完成之后调用

- (void)webView:(WKWebView*)webView didFinishNavigation:(WKNavigation*)navigation{

    [SVProgressHUDdismiss]

NSString* jsStr = [NSStringstringWithFormat:@"payResult('%@')",@"true"]

[self.webView evaluateJavaScript:jsStrcompletionHandler:^(id_Nullable result,NSError* _Nullable error) {

NSLog(@"==%@----%@",result, error)

    }]

}