【微信小程序】关于H5跳转微信小程序、微信小程序跳转H5、微信小程序跳转微信小程序的实现方法

RogerQianpeng

已于 2023-04-12 10:11:53 修改

阅读量6.1k

点赞数 2

CC 4.0 BY-SA版权

分类专栏：微信小程序文章标签：微信小程序小程序前端

于 2022-12-08 15:13:33 首次发布

本文链接：https://blog.csdn.net/RogerQianpeng/article/details/128236186

微信小程序专栏收录该内容

11 篇文章

订阅专栏

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页面的实现思路与方案

3 微信小程序跳转到微信小程序

3.1 实现方法

使用微信小程序的navigator标签，navigator

3.2 代码实现

<navigator target="miniProgram" app-id="wxc*********" path="" version="release">
  <button> 
    小程序跳转
  </button>
</navigator>

3.3 其他说明

似乎无法实现一进入页面就跳转
因为wx.navigateTo方法，似乎并不支持跳转跳转到小程序以外的内容，官方文档中对它的url的描述是——

需要跳转的应用内非 tabBar 的页面的路径 (代码包路径), 路径后可以带参数。参数与路径之间使用 ? 分隔，参数键与参数值用 = 相连，不同参数用 & 分隔；如 ‘path?key=value&key2=value2’

故似乎无法实现，还是需要通过上文中的navigator来实现。