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

最核心的一个概念 :

小程序 的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.html

web-view: https://developers.weixin.qq.com/miniprogram/dev/component/web-view.html

小程序可以通过向自己缓世困的服务器发送请求获取用户的openid，然后将openid存储在用户的本地缓存中，每次请求时携带openid即可识别用户身份。在使用webview套用小程序的过程中，可以通过扰念一些返配手段将用户的openid传递到webview中，在webview中获取openid后进行本地存储，然后在需要识别用户身份的时候读取该openid即可。当然，这种方法需要配合小程序后台接口实现，确保传递的openid是正确的并具有唯一性。

微信小程序是一种全新的连接用户与服务的方式，它可以在微信内被便捷地获取和传播，同时具有出色的使用体验。同时提供一系列工具帮助开发者快速接入并完成小程序开发。关于如何注册配置就不多言了，本文主要还是体验了下 web-view 的功能。

有了这个组件之后，小程序可以很好的嵌入一些页面，可以环境小程序 size 告急的问题，同样也使开发更加便捷，毕竟小程序开发者基本都对前端开发较为了解。

说再多还是需要去看官方文档， web-view文档 ,

首先就需要注意：兼容问题， 版本库和对应版本比例

目前而言，基本 80% 的用户会升级微信，所以其实不必担心版本问题，官方截止 2017-12-01 提供的数据也说明 88% 的用户支持 web-view 。

web-view 组件是一个可以用来承载网页的容器，会自动铺满整个小程序页面；

属性： src 是 String 类型，是一个网站的 url ，默认值是 none ， webview 指向网页的链接。需登录小程序管理后台配置域名白名单。

可以配合 Page 实例的 onLoad 方法来获取 url 的具体值，也就是一个微信小程序页面中只有一个 web-view ，但是这个 web-view 的内容可以根据上一个页面传递的参数来获取页面 URL ，后面会讲如何实践，

官方提供如下接口：

1. 由小程序到 web-view ,其实本质上 WEB-VIEW 也是小程序的一个页面，所以小程序到 web-view 是正常的小程序间的通信，通过 wx.navigateTo 、 wx.redirectTo ，带上 url 参数, query 参数就像正常 url 的参数一样跟着后面，然后在 web-view 的页面的 Page 实例里面通过 onLoad 的方法的参数来获取 url 的值，设置给 web-view 的 src 属性为改值即可。

2. 由 web-view 到小程序，由于在 web-view 的跳转通常是在 src 对应的网页中的 *** 作来处理的，所以需要结合 jssdk 来处理，不需要 wx.config 配置，直接通过 script 标签来引入 [https://res.wx.qq.com/open/js/jweixin-1.3.0.js](http://link.zhihu.com/?target=https%3A//res.wx.qq.com/open/js/jweixin-1.3.0.js) ，就可以使用 wx.miniProgram.navigateTo 、 wx.miniProgram.navigateBack 、 wx.miniProgram.switchTab 、 wx.miniProgram.reLaunch 、 wx.miniProgram.redirectTo 接口，就像小程序之间的跳转一样，单是只能在当前小程序页面内跳转。

// web-view下的页面内 console.log(window.__wxjs_environment === 'miniprogram') // true

在目前实践了部分 web-view 的功能，

在这个 web-view 中，指向的就是 https://test.com 的内容，所以在在 https://test.com 中跳转出回到小程序，需要修改 https://test.com 中的 JavaScript ,

如果需要使用一些其他的的 jssdk 的方法，那就需要参照公众号的开发配置了。

由于很多使用中的一些问题

---