在现有需求的驱动下, 需要手动生成普通二维码并且携带动态参数来跳转打开小程序实现后续功能,本文章主要用于记录如何配置普通链接二维码打开小程序和配置过程中踩过的坑。
扫码打开小程序接入指南
-
首先在这里选择对应的 协议类型 和 选择大小写
-
填写二维码规则:
- 二维码规则的域名须通过备案的验证。
- 支持 、、开头的链接(如:、、)。
- 一个小程序帐号可配置不多于10个二维码前缀规则。
-
填写前缀占用规则:选择是否独占符合二维码前缀匹配规则的所有子规则
如选择占用,则其他帐号不可申请使用满足该前缀匹配规则的其他子规则。 -
向服务器添加校验文件:
下载随机校验文件,并将文件上传至服务器指定位置的目录下,方可通过所属权校验。
验证文件放置规则: 放置于URL中声明的最后一级子目录下,若无子目录,则放置于host所属服务器的顶层目录下。请根据页面提示将验证文件放置在指定的目录下。
-
设置小程序功能页面:
配置扫描二维码后打开的小程序功能页面路径,如: 。 -
设置测试链接(选填):
填写符合二维码前缀匹配规则的二维码完整链接用于测试,如包括参数,请完整填写。一个规则可以填写不多于5个测试链接,可多次修改。若二维码与测试链接匹配,且用户微信号是小程序指定的管理员/开发者/体验者,将打开指定版本的小程序。
-
用户可以通过微信 “扫一扫” ,扫描该二维码,就会跳到小程序的 对应的功能页面
-
在 中解析 处理拿到的参数,就可以进行后续的逻辑操作了。
将拿到的参数提取成对象的工具类 :
1. 扫码打开小程序出现 “页面不存在”
这个问题纠结了我好久,最后又仔细阅读了一下官方提供的文档,将这个问题解决了。发现还是因为自己阅读文档不仔细造成的,大家只要按照上面的配置实例截图来配置,基本上就是没问题的。这里需要注意的是设置的二维码规则,大家可以注意一下。
2. 测试版本需要注意的几个点
- 测试版本不需要发布也是可以进行测试的;
- 测试阶段不发布,只能扫描测试链接中设置的地址中的二维码,其他的就算符合规范也不可以的。
- 如果是要动态匹配参数,那么动态部分必定是 / 后面的字符串
- 如果是要动态匹配参数,那么提交的地址最后一定带 /
- 提交的规则地址对应的项目路径下必须有验证文件,所以不建议设置过长的规则路径
其实扫普通链接二维码打开小程序的配置和使用还是比较简单的,应用场景也是比较多的,只不过第一次配置的时候还是需要细心一点的,避免多次重复操作。