五、配置流程

登录微信小程序后台,进入“开发管理-开发设置-扫普通链接二维码打开微信小程序”,开启功能后即可配置二维码规则。

5.1 二维码规则

根据二维码跳转规则,开发者需要填写需要跳转微信小程序的二维码规则。要求如下:

  1. 二维码规则的域名必须通过ICP备案的验证。
  2. 支持http、https开头的链接(如:http://wx.qq.comhttps://wx.qq.com/mp/https://wx.qq.com/mp?id=123)。
  3. 部分账号支持hlht开头的链接,且根据协议规则,hlht链接的参数在中间,以运营商ID结尾。(如:http://******.运营商ID
  4. 一个微信小程序账号可配置不超过100个二维码前缀规则。

5.2 前缀占用规则

开发者可选择是否占用符合二维码匹配规则的所有子规则。如果选择占用,则其他账号不可申请使用满足该前缀匹配规则的其他子规则。

例如:如果开发者A配置二维码规则:https://wx.qq.com/mp?id=123,并选择“占用所有子规则”,其他开发者将不能配置满足前缀匹配的子规则如https://wx.qq.com/mp?id=1234

如果提示“此规则已被占用”,请联系对应微信小程序开发者沟通解决。

5.3 校验文件

下载随机校验文件,并将文件上传至服务器指定位置的目录下,才能通过所属权校验。

验证文件放置规则:放置于URL中声明的最后一级子目录下,如果没有子目录,则放置于host所属服务器的顶层目录下。请根据页面提示将验证文件放置在指定的目录下。

5.4 微信小程序功能页面

配置扫描二维码后打开的微信小程序功能页面路径,例如:pages/index/index

5.5 测试调试

开发者可对已配置的二维码规则进行测试和调试。

测试仅对指定的测试链接和测试范围内的微信用户生效,其他用户扫码后跳转网页,不影响全网用户正常使用。在二维码规则发布后,开发者仍然可以选择在指定版本(开发版/体验版/线上版本)下测试,请注意扫码用户要打开开发版必须提交过代码。

  • 测试范围: 开发者可根据开发进度选择在开发版/体验版/线上版本测试“普通二维码跳转微信小程序”的功能。
  • 测试链接: 填写符合二维码前缀匹配规则的二维码完整链接用于测试,如果包括参数,请完整填写。

一个规则可以填写不超过5个测试链接,可多次修改。如果二维码与测试链接匹配,且用户微信号是微信小程序指定的管理员/开发者/体验者,将打开指定版本的微信小程序。

5.6 发布

测试完成后开发者可将二维码跳转规则发布到现网,发布后扫描所有符合匹配规则的二维码,将跳转至指定的微信小程序页面。

为确保用户体验,微信小程序必须先发布代码才可以发布二维码跳转规则。

一个微信小程序账号一个月可发布不超过500次二维码跳转规则。