概述
普通的H5是无法跳转小程序的。在手机微信内打开的H5网页可通过开放标签 跳转微信小程序(目前电脑微信不会渲染跳转按钮)。具体使用、权限说明,请阅读微信官方文档。
使用步骤文档有详细说明,这里简单概括如下:
- 登录微信公众平台进入“公众号设置”的“功能设置”里填写“JS接口安全域名” 。
- 后端开发提供获取签名相关字段的接口。
- 微信公众平台查看
所需跳转的小程序原始id ,注意是gh_ 开头的。 - 按官方文档准备
html 文件,部署到绑定域名的服务器上。(文末有完整的示例代码,供参考) - 在手机微信内打开部署好的
html 文件。正常情况下,会出现小程序的按钮,点击可跳转小程序。
可能遇到的错误
这些都时我开发遇到的错误,下面列出了原因和解决办法。如果你也遇到了,希望对你有帮助。
非法签名
错误描述:jssdk 报错 config:invalid signature。如下图:

原因:签名用的url是后端自己取,
解决办法:前端动态获取location.href.split('#')[0] ,传给服务端就正确啦。
const url = encodeURIComponent(location.href.split('#')[0]);
fetch(`/wechat/index?url=${url}`).then(res => {
return res.json()
})
复制代码
如果不是url的问题,就麻烦后端同学对照文档,阅读附录1-JS-SDK使用权限签名算法、附录5-常见错误及解决方法,确认签名算法是否正确。
信息不完整,无法启动
错误描述:点击打开小程序的按钮,点击允许后,toast 提示 “信息不完整,无法启动”。
原因:开发标签的 username 不正确。我当时就是写成了配套公众号的原始id 。/(ㄒoㄒ)/~~
解决:请再次你的确定 标签的 username 参数是 gh_ 开头的目标小程序的原始id 。
jweixin引入时报错
错误描述:uni-app 项目中,vue 文件 require('../../common/jweixin-1.6.0.js') ,报错。

原因:jweixin 里执行this.document.title ,this 期望指向window ,但uni-app 打包构建后this 指向了undefined 。
解决办法:
- 改
jweixin-1.6.0.js 源码文件,将第一个this 改成window 。 uni-app h5 支持自定义模板,在模板中直接使用script 标签引入就没有这个问题啦。- 更多解法参考这个回答。
vue 文件template标签冲突
错误描述:将如下内容粘贴到vue文件的template出现一大堆报错。
复制代码
官方说明如下:
对于Vue等视图框架,为了避免template标签冲突的问题,可使用
复制代码
wx-open-launch-weapp 里标签样式问题
问题描述:打开小程序按钮,要固定在屏幕右下方,使用fixed 定位,发现标签不见了?按钮line-height 设置为100rpx ,不生效?
官方说明如下:
页面中与布局和定位相关的样式,如position: fixed; top -100; 等,尽量不要写在插槽模版的节点中,请声明在标签或其父节点上。
除了官方说明,实践总结如下几点:
- 插槽模版的节点,不能使用rpx,定义的scss变量名当然也不可以(复制粘贴注意下/(ㄒoㄒ)/~~)。
- 插槽模版的节点,设置宽高100%无效。
- 父节点可设置
fixed 等,定位、布局类样式可写在父节点上,插槽节点放在里面就能实现你想要的布局。 - 父节点使用flex 布局,可能会出现样式。(本来想用flex布局实现居中的,结果不行)
html 示例代码
<html>
<head>
<meta charset="utf-8">
<script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js">script>
head>
<body>
<script>
const url = encodeURIComponent(location.href.split('#')[0]);
fetch(`/wechat/index?url=${url}`).then(res => {
return res.json()
}).then(({ signPackage }) => {
const { timestamp, nonceStr, signature, appId } = signPackage
wx.config({
debug: true,
appId,
timestamp,
nonceStr,
signature,
jsApiList: ['openLocation'],
openTagList: ['wx-open-launch-weapp'],
})
})
script>
<wx-open-launch-weapp id="launch-btn" username="gh_xxxxxxx" path="pages/brand/brand.html">
<template>
<style>
.btn {
padding: 10px;
}
style>
<button class="btn">打开小程序button>
template>
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>
body>
html>
复制代码 uni-app 项目的 vue 示例代码
|