【微信小程序】关于H5跳转微信小程序、微信小程序跳转H5、微信小程序跳转微信小程序的实现方法-CSDN博客
?
0 说明
业务提出需求,要实现H5跳转微信小程序的需求,在浏览器、微信环境下,都能通过H5跳转进入小程序。
另外,本文也将微信小程序跳转到H5,以及微信小程序跳转到微信小程序的方法进行汇总。
对于,微信公众号跳转微信小程序、微信小程序跳转微信公众号,本文不会涉及。
1 H5跳转到微信小程序
写在前面:以下是跳转到自己的小程序的,如果要跳转到三方公司的小程序,建议由三方公司提供h5,h5中由三方公司自己请求自己的后端接口动态生成小程序跳转链接,这样可以避免我们去调用外部接口。
1.1 官方文档
获取 URL Scheme
小程序链接生成与使用规则调整公告
获取 URL Link
静态网站
跳转小程序:wx-open-launch-weapp
1.2 实现思路
微信提供了多种实现到跳转到微信小程序的方法,有些需要云开发、静态网站等等,这里我推荐使用URL Scheme的方式来实现。
URL Scheme,究其本质,是微信提供的一个链接,可以被浏览器识别,并自动跳转打开微信、打开小程序。
生成方式可以参考官方文档:urlscheme.generate
1.3 代码实现
1.3.1 获得URL Scheme
通过请求一个微信提供的api地址,即可获得URL Scheme,注意,在实际项目中该过程应有服务端实现,本文只是为了实现一个demo故在前端调用。
请求地址
?
POST https://api.weixin.qq.com/wxa/generatescheme?access_token=ACCESS_TOKEN
请求参数
access_token,jump_wxa,expire_time,具体请见1.2中的官方文档,注意,access_token应拼接在链接中,expire_time可以传空值。
关于access_token的获得方式本文不再赘述,可以参考官方文档auth.getAccessToken,或者参考我的另一篇文章【微信小程序】获取用户手机号的实现,里面有具体的代码示范。
返回值
errcode,errmsg,openlink
其中,openlink就是我们所需要的URL Scheme
代码实现
// 请求参数
const params = {
jump_wxa:{
path: "/pages/login/login", //修改此条,即可跳转到指定页面
query: ""
},
expire_type:'',
}
/**
* 获取URL Scheme
*/
const getData = function(){
// 此处API是封装了的axios
API({
// vue3,vite.config.js做了跨域配置,所以此处为/api开头,实际会转成上文地址
url:'/api/wxa/generatescheme?access_token=*********************',
method:'post',
data: params
}).then((res)=>{
console.log(res)
});
}
?
1.3.2 跳转微信小程序
官方文档中有说明——
“适用于从短信、邮件、微信外网页等场景打开小程序。”
“iOS系统支持识别 URL Scheme,可在短信等应用场景中直接通过 Scheme 跳转小程序。Android系统不支持直接识别 URL Scheme,用户无法通过 Scheme 正常打开小程序,开发者需要使用 H5 页面中转,再跳转到 Scheme 实现打开小程序。”
“可以在用户打开 H5 时立即调用,也可以在用户触发事件后调用。”
获得URL Scheme之后,可以让用户通过点击按钮的方式跳转
?
//跳转小程序
const gotoMini = function(){
window.location.href = 'weixin://dl/business/?t=foyhCmtXlPr'
}
也可以直接在打开页面之后,自动跳转
function setup() {
onMounted(() => {
window.location.href = 'weixin://dl/business/?t=foyhCmtXlPr'
})
}
setup()
总之,打开方式十分灵活
1.4 其他说明
获得access_token,URL Scheme的请求,在实际项目中都应该由服务端发起
通过微信聊天中发送h5地址再点击的方式,即可测试微信内浏览器环境,经测试,外部浏览器、微信内部浏览器,均可实现h5跳转小程序。
单个小程序,每天生成URL Scheme上限为50万条,每条有效期为30天,一条URL Scheme被某个用户使用之后,就为该用户独有,其他用户不能使用。
建议使用方法请参考小程序链接生成与使用规则调整公告,微信推荐的请求时机是在某用户打开H5时进行请求,并且将获得的URL Scheme保存在服务器,下次该用户再访问时将不再重复请求微信api,直到该条URL Scheme过期,也可以在浏览器缓存中进行保存,从而优化减少请求数量。
只能跳转到已经发布的小程序。
2 微信小程序跳转到H5
使用<web-view><web-view/>即可
具体实现与优化可以参考我的另一篇文章:
【微信小程序】微信小程序跳转H5页面的实现思路与方案
使用微信小程序的navigator
标签,navigator
<navigator target="miniProgram" app-id="wxc*********" path="" version="release">
<button>
小程序跳转
</button>
</navigator>
似乎无法实现一进入页面就跳转
因为wx.navigateTo
方法,似乎并不支持跳转跳转到小程序以外的内容,官方文档中对它的url
的描述是——
需要跳转的应用内非 tabBar 的页面的路径 (代码包路径), 路径后可以带参数。参数与路径之间使用 ? 分隔,参数键与参数值用 = 相连,不同参数用 & 分隔;如 ‘path?key=value&key2=value2’