app嵌入的H5页面可以通过URL Scheme跳转小程序。URL Scheme是一种通过特定格式的URL来启动应用程序或打开应用程序内特定页面的方法。在H5页面中,可以通过获取URL Scheme来实现跳转小程序的功能。
实现方式
- 通过微信官方提供的标签wx-open-launch-weapp:这种方式适用于在微信浏览器内的H5页面跳转小程序。已认证的服务号可以在其绑定的“JS接口安全域名”下的网页使用此标签跳转任意合法合规的小程序。
- 通过获取URL Scheme:这种方式适合在外部浏览器运行的H5页面,通过服务端接口生成URL
Scheme,然后通过前端代码调用这个Scheme来实现跳转。
示例代码
- 使用wx-open-launch-weapp标签的示例代码如下:
<wx-open-launch-weapp id="launch-btn" appid="wx12345678" path="pages/home/index?user=123&action=abc">
<script type="text/wxtag-template">
<button class="btn">打开小程序</button>
</script>
</wx-open-launch-weapp>
<script>
var btn = document.getElementById('launch-btn');
btn.addEventListener('launch', function(e) { console.log('success'); });
btn.addEventListener('error', function(e) { console.log('fail', e.detail); });
</script>
- 使用URL Scheme的示例代码如下
明文 URL Scheme示例:(链接长期有效,path路径要在小程序后台【隐私与安全-明文URL】配置才能跳转)
function openWeapp() {
location.href = 'weixin://dl/business/appid=*APPID*&path=*PATH*&query=*QUERY*&env_version=*ENV_VERSION*';
}
其中,各个参数的定义如下:
【必填】APPID:通过明文 URL Scheme 打开小程序的 appid ;
【必填】PATH:通过明文 URL Scheme 打开小程序的页面 path ,必须是已经发布的小程序存在的页面,不可携带 query;
【选填】QUERY:通过明文 URL Scheme 打开小程序的 query ,最大512个字符,只支持数字,大小写英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~%`,需要url_encode;
【选填】ENV_VERSION:要打开的小程序版本,正式版为release,体验版为trial,开发版为develop,仅在微信外打开时生效。注意:若不填写,则默认打开正式版小程序。
通过明文 URL Scheme 打开小程序的场景值为 1286。
- 加密 URL Scheme
具体使用方式查看官网:https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/url-scheme.html
注意事项
环境判断:在微信环境中,建议使用wx-open-launch-weapp标签,因为微信浏览器不支持URL Scheme跳转