微信公众号开发（三）微信 h5 跳转小程序

2020-12-23

引言

H5网页接入公众号的 JSSDK 以后终于可以跳转到小程序了，正好项目中有这个需求，于是就来踩坑了。

版本要求：

微信版本要求为：7.0.12及以上。系统版本要求为：iOS 10.3 及以上、Android 5.0 及以上。

使用步骤

微信开放标签使用步骤与微信 JS-SDK 类似，也需要引入 JS 文件等步骤。如果是公众号身份的网页，需要绑定安全域名，因我的项目是公众号，所以需要去绑定域名

一、绑定域名

登录微信公众平台进入“公众号设置”的“功能设置”里填写“ 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 标准模块加载方法加载。

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

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

这里需要后台提供一个接口，返回所需的时间戳，签名，随机串，appId （ appId 可以接口返回，也可以前端根据分环境打包去配置）
需要注意的是，signature 此签名是由后端通过 jsapi_ticket 、noncestr 、 timestamp 、url ( 当前页面 location.href ) 来生成的。 url需要前端传给后端。在项目中遇到一个签名失败的问题，接口信息返回了签名等信息，但是 debug 却是签名失败，此时要检查下是不是 token 或者 ticket 过期了。

// 获取微信配置
getConfig () {
  // 这里是接口调用，需要传 url ，返回所需要的签名等参数
  const url = window.location.href.split('#')[0]
  this.log(url)
  const param = {
    url: url
  }
  this.$api.user.getConfigData(param).then(res => {
    console.log('config配置', res)
    const self = this
    if (res.data.code === 200) {
      // eslint-disable-next-line no-undef
      wx.config({
        debug: false, // 开启调试模式,调用的所有api的返回值会在客户端alert出来，若要查看传入的参数，可以在pc端打开，参数信息会通过log打出，仅在pc端时才会打印
        appId: process.env.appid, // 必填，公众号的唯一标识
        timestamp: res.data.item.timestamp, // 必填，生成签名的时间戳
        nonceStr: res.data.item.nonceStr, // 必填，生成签名的随机串
        signature: res.data.item.signature, // 必填，签名
        jsApiList: ['chooseImage'], // 必填，需要使用的JS接口列表，因为是必填项，这里可以随意写一个
        openTagList: ['wx-open-launch-weapp'] // 可选，需要使用的开放标签列表，这里写跳转小程序的开放标签 ['wx-open-launch-weapp']
      })
      wx.ready(function () {
        self.$nextTick(() => {
          try {
            var btn = document.getElementById('launch-btn')
            btn.addEventListener('launch', function (e) {
              console.log('success')
              console.log(e)
            })
            btn.addEventListener('error', function (e) {
              console.log('fail', e)
            })
          } catch (error) {

          }
        })
      })
    }
  })
}

四、通过 ready 接口处理成功验证

这个步骤在第三步中已经一起写明了，可参考第三步

五、通过 error 接口处理失败验证

可以通过 error 查看失败信息

1
2
3

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

六、开放标签的使用

小程序跳转按钮：

用于页面中提供一个可跳转指定小程序的按钮。使用此标签后，用户需在网页内点击标签按钮方可跳转小程序。

属性

名称	必填	备注
username	是	所需跳转的小程序原始id，即小程序对应的以gh_开头的id
path	否	所需跳转的小程序内页面路径及参数

备注：对于path属性，所声明的页面路径必须添加.html后缀，如pages/home/index.html。

<wx-open-launch-weapp
     id="launch-btn"
     :username="val.appid"
     :path="val.path"
   >
     <script type="text/wxtag-template">
       <style>
         .goodsname {
           width: 60px;
           height: 25px;
           border-radius: 4px;
           border: none;
           padding: 0;
           font-size: 11px;
           color: #fff;
           background: #59718E;
           line-height: 25px;
           text-align: center;
         }
       </style>
       <h1 class="goodsname">打开小程序</h1>
     </script>
   </wx-open-launch-weapp>

这里需要注意的是，官方文档中使用的是 template 标签，但是在 vue 项目中会有冲突，所以这里换成了标签

参考文章：【开放标签说明文档】

公众号域名配置以及微信授权，可以参考我之前的文章
微信公众号开发（一）准备工作
 微信公众号开发（二）网页授权

展开全文 >>