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、网站配置(这个问题可以忽略,直接复制右下角的下载链接就可以打开页面

 

posted on 2025-07-07 16:51  奔驰的码儿  阅读(719)  评论(0)    收藏  举报

导航