H5静态页面开发环境跳转小程序(微信浏览器,外部浏览器)
一.先贴下官方开发文档,虽没能成功调起小程序,也是可以先看下的
1.官方开发文档参考:https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/staticstorage/jump-miniprogram.html
官方文档只提供了关键代码,但是没说怎么上传静态文件,怎么上传云函数。
二.如何在浏览器中拉起小程序
三. 需要准备的工具、材料
微信开发者工具、非个人主体并且已认证的(微信认证)小程序。
四. 操作步骤:
1.开通云开发服务、云开发权限设置、开通静态网站功能:
1-1 开通云开发服务,微信开发者工具——云开发
创建云开发环境,设置环境名称、付费方式(默认预付费,可以选按量付费,有一定免费额度的,无论个人开发调试还是公司项目使用,选按量付费就好了)
开通成功之后,概览界面右侧,能看到环境id,记住这个id,后边配置h5页面会用到。
1-2 设置云开发权限,设置——权限设置,未登录用户访问云资源权限设置,勾选未登录用户访问权限:
1-3 开通镜头网站,菜单栏”更多“——静态网站——开通
扫码确认,等初始化,可能需要点时间,无需等待,开通成功会有短信通知,可以先进行后边步骤
(开通静态网站需要管理员扫码)
2.创建云开发小程序、设置云开发环境录用户访问云资源权限设置
2-1 创建云开发小程序:
如果小程序已经是云开发服务了,那就可以直接用了。如果不是,那就创建一个云开发小程序。
这个小程序只是用来上传云函数的,appid要填要开通云开发功能的小程序,即h5要跳转的小程序。另外后端服务要选微信云开发,至于模板,随便选个及就行。只是为了实现跳转小程序这个功能,上传云函数而已,上传之后就没用了(除非要更新云函数)。
云开发小程序创建好之后,可以看到有 cloudfunctions 和 miniprogram 两个目录。cloudfunctions 目录就是我们创建、上传云函数要用的目录了。
2-2 设置云开发环境:
cloudfunctions 目录上边单击鼠标右键,设置当前环境,选择前边创建的云环境
3.创建云函数
请注意,这里的创建云函数不是在云开发控制台直接创建的,是需要通过小程序创建并部署的。虽然控制台也可以直接创建,但是不能直接用。别问我怎么知道,踩过这个坑而已。
3-1 下载官方云函数示例代码(
点击下载
https://res.wx.qq.com/op_res/4gUvxyfsT9OaDBWFG_jP-xtGK84CoO_4rQXZpaJhyje-vy3amU1xLctcpyqfyn3D5rgCRBR3EpR5sLO_WSP8eQ
),源码目录如下:
3-2 将 cloudfunctions 目录中的 public 文件夹复制到云开发小程序项目 cloudfunctions 目录下:
3-3 编辑 public/index.js 文件,将 getUrlscheme函数中的path改成要调起小程序的页面路径。
4.安装依赖
鼠标放到public目录上,单击鼠标右键,快捷菜单选中"在内建终端中打开",然后运行 npm install 安装依赖
如果内部中端打不开,可以使用外部终端进行 npm install 命令下载依赖。
5.上传部署云函数:
public 目录上,单击鼠标右键,选择”上传并部署:云端安装依赖(不上传node_modules),
部署后,打开云开发控制台——云函数,就能看到前边创建部署的云函数了:
等几秒钟,云函数就能部署成功了。
6.修改云函数权限:
云开发控制台——云开发——云开发权限,自定义安全规则,点击右侧的“修改”
点允许所有用户访问,这样所有用户都可以免鉴权通过h5调起小程序了
7.编写及上传h5静态页面到云开发环境
编辑前边下载的 h5/jump-mp.html 文件,将所有标注<!-- replace -->的地方都修改成真实的内容就好了。示例代码如下:
1 <html> 2 <head> 3 <title>打开小程序</title> 4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 5 <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1, maximum-scale=1"> 6 <script> 7 window.onerror = e => { 8 console.error(e) 9 alert('发生错误' + e) 10 } 11 </script> 12 <!-- weui 样式 --> 13 <link rel="stylesheet" href="https://res.wx.qq.com/open/libs/weui/2.4.1/weui.min.css"> 14 </link> 15 <!-- 调试用的移动端 console --> 16 <script src="https://cdn.jsdelivr.net/npm/eruda"></script> 17 <script>eruda.init();</script> 18 <!-- 公众号 JSSDK --> 19 <script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script> 20 <!-- 云开发 Web SDK --> 21 <script src="https://res.wx.qq.com/open/js/cloudbase/1.1.0/cloud.js"></script> 22 <script> 23 function docReady(fn) { 24 if (document.readyState === 'complete' || document.readyState === 'interactive') { 25 fn() 26 } else { 27 document.addEventListener('DOMContentLoaded', fn); 28 } 29 } 30 31 32 docReady(async function() { 33 var ua = navigator.userAgent.toLowerCase() 34 var isWXWork = ua.match(/wxwork/i) == 'wxwork' 35 var isWeixin = !isWXWork && ua.match(/micromessenger/i) == 'micromessenger' 36 var isMobile = false 37 var isDesktop = false 38 if (navigator.userAgent.match(/(phone|pad|pod|iPhone|iPod|ios|iPad|Android|Mobile|IEMobile)/i)) { 39 isMobile = true 40 } else { 41 isDesktop = true 42 } 43 44 45 if (isWeixin) { 46 var containerEl = document.getElementById('wechat-web-container') 47 containerEl.classList.remove('hidden') 48 containerEl.classList.add('full', 'wechat-web-container') 49 50 51 var launchBtn = document.getElementById('launch-btn') 52 launchBtn.addEventListener('ready', function(e) { 53 console.log('开放标签 ready') 54 }) 55 launchBtn.addEventListener('launch', function(e) { 56 console.log('开放标签 success') 57 }) 58 launchBtn.addEventListener('error', function(e) { 59 console.log('开放标签 fail', e.detail) 60 }) 61 62 63 wx.config({ 64 debug: false, // 调试时可开启 65 appId: 'wxad8exxxx', // <!-- replace --> 66 timestamp: 0, // 必填,填任意数字即可 67 nonceStr: 'nonceStr', // 必填,填任意非空字符串即可 68 signature: 'signature', // 必填,填任意非空字符串即可 69 jsApiList: ['chooseImage'], // 必填,随意一个接口即可 70 openTagList: ['wx-open-launch-weapp'], // 填入打开小程序的开放标签名 71 }) 72 } else if (isDesktop) { 73 // 在 pc 上则给提示引导到手机端打开 74 var containerEl = document.getElementById('desktop-web-container') 75 containerEl.classList.remove('hidden') 76 containerEl.classList.add('full', 'desktop-web-container') 77 } else { 78 var containerEl = document.getElementById('public-web-container') 79 containerEl.classList.remove('hidden') 80 containerEl.classList.add('full', 'public-web-container') 81 var c = new cloud.Cloud({ 82 // 必填,表示是未登录模式 83 identityless: true, 84 // 资源方 AppID 85 resourceAppid: 'wxad8exxxx', // <!-- replace --> 86 // 资源方环境 ID 87 resourceEnv: 'cloud-mall-2gs0uxxxx', // <!-- replace --> 88 }) 89 await c.init() 90 window.c = c 91 92 93 var buttonEl = document.getElementById('public-web-jump-button') 94 var buttonLoadingEl = document.getElementById('public-web-jump-button-loading') 95 try { 96 await openWeapp(() => { 97 buttonEl.classList.remove('weui-btn_loading') 98 buttonLoadingEl.classList.add('hidden') 99 }) 100 } catch (e) { 101 buttonEl.classList.remove('weui-btn_loading') 102 buttonLoadingEl.classList.add('hidden') 103 throw e 104 } 105 } 106 }) 107 108 109 async function openWeapp(onBeforeJump) { 110 var c = window.c 111 const res = await c.callFunction({ 112 name: 'public', 113 data: { 114 action: 'getUrlScheme', 115 }, 116 }) 117 console.warn(res) 118 if (onBeforeJump) { 119 onBeforeJump() 120 } 121 location.href = res.result.openlink 122 } 123 </script> 124 <style> 125 .hidden { 126 display: none; 127 } 128 129 130 .full { 131 position: absolute; 132 top: 0; 133 bottom: 0; 134 left: 0; 135 right: 0; 136 } 137 138 139 .public-web-container { 140 display: flex; 141 flex-direction: column; 142 align-items: center; 143 } 144 145 146 .public-web-container p { 147 position: absolute; 148 top: 40%; 149 } 150 151 152 .public-web-container a { 153 position: absolute; 154 bottom: 40%; 155 } 156 157 158 .wechat-web-container { 159 display: flex; 160 flex-direction: column; 161 align-items: center; 162 } 163 164 165 .wechat-web-container p { 166 position: absolute; 167 top: 40%; 168 } 169 170 171 .wechat-web-container wx-open-launch-weapp { 172 position: absolute; 173 bottom: 40%; 174 left: 0; 175 right: 0; 176 display: flex; 177 flex-direction: column; 178 align-items: center; 179 } 180 181 182 .desktop-web-container { 183 display: flex; 184 flex-direction: column; 185 align-items: center; 186 } 187 188 189 .desktop-web-container p { 190 position: absolute; 191 top: 40%; 192 } 193 </style> 194 </head> 195 <body> 196 <div class="page full"> 197 <div id="public-web-container" class="hidden"> 198 <p class="">正在打开 “xxxx”...</p> <!-- replace --> 199 <a id="public-web-jump-button" href="javascript:" class="weui-btn weui-btn_primary weui-btn_loading" 200 onclick="openWeapp()"> 201 <span id="public-web-jump-button-loading" class="weui-primary-loading weui-primary-loading_transparent"><i 202 class="weui-primary-loading__dot"></i></span> 203 打开小程序 204 </a> 205 </div> 206 <div id="wechat-web-container" class="hidden"> 207 <p class="">点击以下按钮打开 “xxxx”</p> <!-- replace --> 208 <!-- 跳转小程序的开放标签。文档 https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_Open_Tag.html --> 209 <wx-open-launch-weapp id="launch-btn" username="gh_783bxxxx" path="/pages/login/index"> 210 <!-- replace --> 211 <template> 212 <button 213 style="width: 200px; height: 45px; text-align: center; font-size: 17px; display: block; margin: 0 auto; padding: 8px 24px; border: none; border-radius: 4px; background-color: #07c160; color:#fff;">打开小程序</button> 214 </template> 215 </wx-open-launch-weapp> 216 </div> 217 <div id="desktop-web-container" class="hidden"> 218 <p class="">请在手机打开网页链接</p> 219 </div> 220 </div> 221 </body> 222 </html>
关键修改点在这三处:
8上传h5页面到云开发环境:
云开发控制台——更多——静态网站——文件管理,点击上传文件,选择上边改好的h5页面即可
上传成功:
9.测试验证、配置域名:
静态网站窗口,选择”网站配置“,可以看到已经分配了测试域名,可以直接复制这个页面到手机浏览器中直接打开,如果前边操作没有遗漏的话,就能在浏览器中调起微信小程序了。
四.开发中遇到的异常情况排雷:(注意下面几点注意事项) 看完看完看完!!!!
1.-501000:environment not found 未找到环境,检查html文件中云环境id配置,直接复制云开发控制平台概览中的环境ID就好了,如下:
2.-501023: permission denied 没有权限,云开发控制平台——设置——权限设置——勾选”未登录用户访问权限“就好了
3、网站配置(这个问题可以忽略,直接复制右下角的下载链接就可以打开页面)