微信公众号h5跳转小程序

最近在公司做活动,遇到了h5活动页面唤起小程序的需求, 找了资料,发现了wx-open-launch-open。
微信官方文档 支持了这种跳转,不过对微信版本、系统版本都有要求。

因为需求需要判断当前用户是否支持,不支持则显示别的内容,支持就点击后直接跳转到小程序。开始我的探索路

前提

绑定域名

这个微信官方文档里面说的很清楚,登录微信公众平台进入“公众号设置”的“功能设置”里填写“JS接口安全域名”。

引入js文件

在需要调用JS接口的页面引入如下JS文件:http://res.wx.qq.com/open/js/jweixin-1.6.0.js (支持https)

如需进一步提升服务稳定性,当上述资源不可访问时,可改访问:http://res2.wx.qq.com/open/js/jweixin-1.6.0.js (支持https)

备注:支持使用 AMD/CMD 标准模块加载方法加载
(ps:因为我们的h5页面是https, 所以引入的连接要是https的,不然会有问题呦)

通过config接口注入权限验证配置并申请所需开放标签

与使用JS-SDK配置方式相同,所有需要使用开放标签的页面必须先注入配置信息,并通过openTagList字段申请所需要的开放标签,否则将无法使用(同一个url仅需调用一次)。开放标签的申请和JS接口的申请相互独立,因此是可以同时申请的。

1
2
3
4
5
6
7
8
9
wx.config({
debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印
appId: '', // 必填,公众号的唯一标识
timestamp: , // 必填,生成签名的时间戳
nonceStr: '', // 必填,生成签名的随机串
signature: '',// 必填,签名
jsApiList: [], // 必填,需要使用的JS接口列表
openTagList: [] // 可选,需要使用的开放标签列表,例如['wx-open-launch-app']
});

通过ready接口处理成功验证

1
2
3
wx.ready(function () {
// config信息验证后会执行ready方法,所有接口调用都必须在config接口获得结果之后,config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中
});

通过error接口处理失败验证

1
2
3
wx.error(function (res) {
// config信息验证失败会执行error函数,如签名过期导致验证失败,具体错误信息可以打开config的debug模式查看,也可以在返回的res参数中查看,对于SPA可以在这里更新签名
});

使用说明

所有开放标签都能像普通的HTML标签一样在页面中直接使用,不需要再进行额外的处理。

(ps: 我们使用的是react,所有也是使用的script)

对于标签事件,均可通过event.detail获得详细信息。如果无特殊说明,下文标签事件说明中的返回值均指代event.detail中的内容。

另外,需要注意以下几点:如果所使用的标签允许提供插槽,由于插槽中模版的样式是和页面隔离的,因此需要注意在插槽中定义模版的样式。插槽模版及样式均需要通过

1
<template></template>

进行包裹。对于Vue等视图框架,为了避免template标签冲突的问题,可使用

1
<script type="text/wxtag-template"><script>

进行代替,来包裹插槽模版和样式。另外,对于具名插槽还需要通过slot属性声明插槽名称,下文标签插槽中的default插槽为默认插槽,可不声明插槽名称。

页面中与布局和定位相关的样式,如position: fixed; top -100;等,尽量不要写在插槽模版的节点中,请声明在标签或其父节点上;
对于有CSP要求的页面,需要添加白名单frame-src https://*.qq.com webcompt:,才能在页面中正常使用开放标签。

使用过程中的问题

跳转小程序按钮没有显示

没有起作用有好几个方便的原因:
1.微信公众号必须是服务号。要在公众号后台配置js安全域名 和 ip白名单
2.真机测试,才会显示(我使用微信开发者工具也不会显示的)
3、username=小程序的原始id,以gh开头的,不是小程序wx开头的id
4、path=‘*.html’后面要以.html结尾(这个微信官方文档也有写)
5、openTagList: [“wx-open-launch-weapp”] config配置参数必须填这个开放接口

自定义图片按钮

1、图片连接必须是线上的,不能是本地图片,不然不会显示

1
2
3
4
5
6
7
8
9
10
11
12
<div className="banner-button">
<wx-open-launch-weapp
id="launch-btn"
username={this.state.miniUsername}
path={this.state.miniPath}
style={{width: "150px", height: "32px", fontSize: "23px"}}>
<script type="text/wxtag-template">
<img style={{width: "100%"}} src="https://images-1254198035.cos.ap-shanghai.myqcloud.com/qipai/btn.png" alt=""/> (线上图片会显示)
<img style={{width: "100%"}} src="../image/btn.png" alt=""/>(本地图片不会显示)
</script>
</wx-open-launch-weapp>
</div>

跳转小程序按钮样式不起作用

注意:样式无法写在外面,只能使用内联样式。固定大小的样式不支持rem单位,不会继承样式

判断当前是否支持wx-open-launch-open按钮(手机不支持wx-open-launch-open)

因为需要对不支持wx-open-launch-open按钮的做判断,显示另一个页面,所以需要判断当前手机是否支持

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// wx-open-launch-weapp按钮 微信版本要求为:7.0.12及以上。 系统版本要求为:iOS 10.3及以上、Android 5.0及以上。
var wechatInfo = navigator.userAgent.match(/MicroMessenger\/([\d\.]+)/i);
console.log("wechatInfo:", wechatInfo && wechatInfo[1]);
// Android 5.0及以上
var ua = navigator.userAgent.toLowerCase();
console.log(ua);
if (!wechatInfo) {
console.log("仅支持微信") ;
} else if (wechatInfo[1] < "7.0.12") {
console.log("微信版本要求7.0.12及以上版本")
} else if (/android/i.test(navigator.userAgent)) {
var test = /android\s([\w.]+)/;//IE
var match = test.exec(ua);
console.log(match);
document.write("This is Android " + match[1] + " browser."); //这是Android平台下浏览器
var version = match[1].split(".")[0];
if (version < 5) {
console.log('Android系统要求5.0及以上版本');
}
} else if (/(iPhone|iPad|iPod|iOS)/i.test(navigator.userAgent)) {
var test = /os\s([\w_]+)/;//IE
var match = test.exec(ua);
var version = match[1].split("_")[0] + "." + match[1].split("_")[1];
console.log(version);
if (version < 10.4) {
console.log('ios系统要求10.3及以上版本');
}
}

很多东西网上都是可以找到的, 这里面大部分内容都是我在网上可以看到的。