有个H5（vue项目），需要实现点击商品item跳转到小程序，微信内和微信外都要支持，这里我们只介绍一下H5在微信外的跳转。
如图所示，红框内是一个商品，就是点击这里，要跳转小程序：
跳转的小程序路径
queryData
object
{}
携带的参数
ready
any
只有当ready为true的时候，才会去执行最后一步 调用云函数，用于依赖一些异步数据的情况
callFunctionName
string
'openMiniapp'
调用的云函数的名称
ghid
string
小程序的原始id （gh开头的那个）
appid
string
小程序的appid
envid
string
云开发的云环境id
附：
云环境id的位置：
而云函数其实只需要初始化一次，因为云函数是挂到window上的。即使是微信内的H5，每个页面wx jssdk也只需要初始化一次。
所以这里增加了个window.jumpAppState的变量用来判断当前页面是否正在初始化和是否初始化完成，用window.location.hash作为key，用来区分不同的页面。
async mounted() { console.log('jumpApp mounted') if (!window.jumpAppState) window.jumpAppState = {} // console.log(window.jumpAppState[`isReady_${window.location.hash}`]) // console.log(window.jumpAppState[`isGettingReady_${window.location.hash}`]) // 先配置 if (!window.jumpAppState[`isReady_${window.location.hash}`] && !window.jumpAppState[`isGettingReady_${window.location.hash}`]) { console.log('进入配置') window.jumpAppState[`isGettingReady_${window.location.hash}`] = true await this.preConfig() window.jumpAppState[`isGettingReady_${window.location.hash}`] = false window.jumpAppState[`isReady_${window.location.hash}`] } // 先配置 end console.log('配置完毕') this.isPreConfigFinish = true },复制代码methods: { ... // 微信外 async initOutWeixin() { const self = this let res try { res = await window.tcb.callFunction({ name: self.callFunctionName, // 提供UrlScheme服务的云函数名称 data: { path: self.path, queryData: self.queryData, }, }) } catch (e) { console.log('云函数失败了', e) } console.log('云函数结果', res) this.minihref = res?.result?.openlink ?? '' this.isInitWechatFinish = true }, // 微信外跳转小程序 click handleOutWeixinClick() { if (!isWeixin() && this.minihref && this.isInitWechatFinish) { window.location.href = this.minihref } }, ...}复制代码· isPreConfigFinish
代表window.tcb是否init完成（如果是微信内的话，代表wx jssdk是否config完成）
· isCanInitWechat
是否preConfig完成，同时外部的一些参数是否准备好了。
因为有时我们跳转时携带的参数是异步获取的，比如订单号、商品code等，所以设置了一个props.ready的变量。
只有当isPreConfigFinish已经为true，且一些异步的数据已经拿到即props.ready为true的时候，isCanInitWechat为true
· isInitWechatFinish
代表云函数调用成功了，拿到了openLink（微信内的话，就是wxjssdk config成功，并且<wx-open-launch-weapp/>已经加到了html里）
最终拿到的这个minihref就是类似这种的地址："weixin://dl/business/?ticket=slejlsdjlf"，我们直接调用window.location.href = this.minihref 就能触发跳转小程序了。
<template> <view class="p_1646876870010"> <div class="open_app_div" @click="handleOutWeixinClick" v-html="openWeappBtnHtml"></div> <slot></slot> </view></template><script>import { ref, onMounted } from 'vue'import { configWx } from '@/services/wx'import { jumpAppGhCode } from '@/utils/consts'import { isWeixin } from '@/utils/utils_h5'// 因为一个页面可能有多个 JumpApp组件，用window 保存是否配置成功的状态，并且用当前页面的hash值区分 window.location.hash// window.jumpAppState = {// [`isGettingReady_${window.location.hash}`]: false,// [`isReady_${window.location.hash}`]: false,// }/** * 顺序： （几个变量） * 1、preConfig * 2、外部的ready 可以了 * * 注：1、2 完成之后 isCanInitWechat 变为true ，开始init微信小程序的跳转 * * 3、isInitWechatFinish 最终成功了 */export default { data() { return { isPreConfigFinish: false, // preConfig是否完成 isInitWechatFinish: false, // 最终成功了 // 微信内 openWeappBtnHtml: '', // 微信外 minihref: '', } }, props: { // path 不需要带 '/' path: { type: String, }, queryData: { type: Object, default: () => ({}), }, ready: {}, // 其它的外部的数据是否准备好 ready 为true的时候 才 添加wx-open-launch-weapp 或者 触发云函数 // 调用的云函数名称 callFunctionName: { type: String, default: 'openMiniapp', }, /** * 微信内 */ ghid: { type: String, }, /** * 微信外 */ appid: { type: String, }, // 云环境id envid: { type: String, }, }, computed: { isCanInitWechat() { return this.isPreConfigFinish && this.ready }, }, watch: { isCanInitWechat(v) { if (v) { setTimeout(() => { if (isWeixin()) { this.initInWeixin() } else { this.initOutWeixin() } }, 0) } }, }, async mounted() { console.log('jumpApp mounted') if (!window.jumpAppState) window.jumpAppState = {} // console.log(window.jumpAppState[`isReady_${window.location.hash}`]) // console.log(window.jumpAppState[`isGettingReady_${window.location.hash}`]) // 先配置 if (!window.jumpAppState[`isReady_${window.location.hash}`] && !window.jumpAppState[`isGettingReady_${window.location.hash}`]) { console.log('进入配置') window.jumpAppState[`isGettingReady_${window.location.hash}`] = true await this.preConfig() window.jumpAppState[`isGettingReady_${window.location.hash}`] = false window.jumpAppState[`isReady_${window.location.hash}`] } // 先配置 end console.log('配置完毕') this.isPreConfigFinish = true }, methods: { // 先配置 async preConfig() { const self = this if (isWeixin()) { return await configWx([], ['wx-open-launch-weapp']) } else { if (!window.tcb) { window.tcb = new window.cloud.Cloud({ identityless: true, resourceAppid: self.appid, resourceEnv: self.envid, }) } return await window.tcb.init() } }, // 微信内 async initInWeixin() { console.log('微信内') // 获取queryStr let queryStrArr = [] for (let key in this.queryData) { const str = `${key}=${this.queryData[key]}` // name=tom queryStrArr.push(str) } const queryStr = queryStrArr.join('&') const jumpPath = `${this.path}?${queryStr}` this.openWeappBtnHtml = ` <wx-open-launch-weapp id="launch-btn" username="${this.ghid}" path="${jumpPath}" style="background-color:transparent;" > <template> <div style="width:800px;padding:100px;color:transparent;background-color:transparent;font-size:14px">跳转</div> </template> </wx-open-launch-weapp> ` this.isInitWechatFinish = true }, // 微信外 async initOutWeixin() { const self = this let res try { res = await window.tcb.callFunction({ name: self.callFunctionName, // 提供UrlScheme服务的云函数名称 data: { path: self.path, queryData: self.queryData, }, }) } catch (e) { console.log('云函数失败了', e) } console.log('云函数结果', res) this.minihref = res?.result?.openlink ?? '' this.isInitWechatFinish = true }, // 微信外跳转小程序 click handleOutWeixinClick() { if (!isWeixin() && this.minihref && this.isInitWechatFinish) { window.location.href = this.minihref } }, }, // methods end}</script><style lang="less">.p_1646876870010 { position: relative; overflow: hidden; .open_app_div { position: absolute; top: 0; bottom: 0; left: 0; right: 0; }}</style>复制代码/** * @param {Array<string>} jsApiArr * @returns */export function configWx(jsApiArr = [], openTagArr = []) { return new Promise(async (resolve, reject) => { if (!wx) return reject() wx.ready(function (res) { // config信息验证后会执行ready方法，所有接口调用都必须在config接口获得结果之后，config是一个客户端的异步操作，所以如果需要在页面加载时就调用相关接口，则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口，则可以直接调用，不需要放在ready函数中。 console.log('wx ready 我打印的', res) return resolve() }) wx.error(function (err) { // config信息验证失败会执行error函数，如签名过期导致验证失败，具体错误信息可以打开config的debug模式查看，也可以在返回的res参数中查看，对于SPA可以在这里更新签名。 console.log('wx error 我打印的', err) return reject(err) }) // 请求 let config = null try { /** * 苹果分享会是调取签名失败是因为:苹果在微信中浏览器机制和安卓不同,有IOS缓存问题，和IOS对单页面的优化问题， * 通俗点说安卓进行页面跳转分享时会刷新当前的url,而苹果不会，苹果是通过历史记录进来的，不会刷新url所以会导致签名失败)。 * * 所以 * 获取signUrl 安卓传全部的href，ios只用传#之前的 */ let signUrl = '' if (isIOS()) { signUrl = window.location.href.split('#')[0] } else { signUrl = window.location.href } const res = await request({ url: '/h5/user/jsapi/initConfig', data: { url: signUrl }, }) config = res?.data ?? {} } catch (error) { return reject(error) } if (config) { wx.config({ // debug: getIsProd() ? false : true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来，若要查看传入的参数，可以在pc端打开，参数信息会通过log打出，仅在pc端时才会打印。 debug: false, appId: appid + '', timestamp: config.timestamp + '', // 必填，生成签名的时间戳 nonceStr: config.nonceStr + '', // 必填，生成签名的随机串 signature: config.signature + '', // 必填，签名 jsApiList: ['hideMenuItems', ...jsApiArr], // 必填，需要使用的JS接口列表 // 这个貌似不能空 openTagList: [...openTagArr], }) } })}如果你觉得此文对你有一丁点帮助，点个赞。或者可以加入我的开发交流群：1025263163相互学习，我们会有专业的技术答疑解惑
如果你觉得这篇文章对你有点用的话，麻烦请给我们的开源项目点点star:http://github.crmeb.net/u/defu不胜感激 ！
PHP学习手册：https://doc.crmeb.com
技术交流论坛：https://q.crmeb.com
