小程序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

方法一：rpn.js：使用rpn.js实现eval函数功能

*** 作链接：网页链接

方法二：

（1）使用Underscore.js： *** 作链接：网页链接

（2）使用Immutable.js： *** 作链接：网页链接

（3）使用UUID、Base64、Chance： *** 作链接：网页链接

扩展微信小程序框架功能（1）——Promise

ES6 对 Promise 有了原生的支持，但微信开发者工具更新版本（0.11.112200）后, 移除了开发者工具对 ES6 中Promise 特性原生的支持, 需要引入第三方的 Promise 库。

扩展微信小程序框架功能（2）——Generator

Generator函数是ES6提供的一种异步编程解决方案，语法行为与传统函数完全不同。

扩展微信小程序框架功能（3）——函数功能增强

Underscore.js 和 Lodash 是最常用的JavaScript库。

扩展微信小程序框架功能（4）——Immutable.js

Immutable.js 是 Facebook 开发的不可变数据集合。Immutable

Data（不可变数据）一旦创建就不能被修改。通过使用Immutable

Data，可以更容易的处理缓存、回退、数据变化检测等问题，应用开发更简单。

扩展微信小程序框架功能（5）——Redux

Redux 是 JavaScript 状态容器，提供可预测化的状态管理。

扩展微信小程序框架功能（6）—日期时间

Moment.js是一个JavaScript的日期、时间处理工具类，其对于JavaScript的日期时间处理功能非常强悍和全面。可以用在浏览器环境中使用，也可以在Node.js中。

扩展微信小程序框架功能（7）——正则表达式

XRegExp 是一个开源的 JavaScript库，提供一个参数化、可扩展的支持各种浏览器的正则表达式的实现库，支持附加语法数纯、标志以及方法。

扩展微信小程序框架功能（8）—此握—Xml处理

x2js是一个 实现 XML 与 JavaScript 对象之间森毕庆相互转换的工具库。

扩展微信小程序框架功能（9）——加解密

node-uuid可以快速地生成符合规范 的 UUID。js-base64可以实现Base64编码和解码。crypto-js可以非常方便地在 JavaScript 进行加解密。

扩展微信小程序框架功能（10）——测试辅助

Chance是一个 JavaScript 随机数生成工具。Mock.js可以生成随机数据，拦截 Ajax 请求。

方法三：moment

*** 作链接：网页链接

1.要携燃注意的是必须要用module.exports导出要调用属性或方法搜隐盯；

2.使用的时候用var api = require('../../utils/api.js')加载代码，然后使用api.SYNC_TABLE_URL 直接调用

3.调用方世和法也差不多。

---