devbox
煮酒与君饮
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

H5静态页面开发环境跳转小程序（微信浏览器，外部浏览器）_h5跳转小程序

作者：煮酒与君饮 | 2024-07-20 23:59:43

赞

踩

h5跳转小程序

网上有很多教程，但是具体的坑避不开，这里就以图文形式全流程介绍如何实现微信外环境静态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 下载官方云函数示例代码（点击下载icon-default.png?t=N7T8https://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 没有权限，云开发控制平台——设置——权限设置——勾选”未登录用户访问权限“就好了

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/煮酒与君饮/article/detail/858919
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号