1

微信小程序Webview与Webapp单页分享交互

在文章开始前,先来看一个效果。

两个跳转效果分别使用 小程序webview跳转到原生小程序页面,以及webapp的路由跳转

你能猜到第1种效果是采用什么跳转吗?

熟悉bui开发的朋友可能已经猜到了,第1种的路由跳转采用的就是BUI的单页开发路由跳转(先加载再跳转),第2种是跳转到小程序的交互效果(先闪白再加载)。得益于单页路由动态加载组件的方式,整体体验感觉会更流畅,更舒服些。

一、开发方式的区别

有小程序,为何还要用webview组件呢?先来梳理下这几种开发方式的区别先。

### 1.Webapp开发

这是传统意义上的h5开发,纯网页版的,真正意义上的一套代码多平台运行,我选用bui作为这个webapp的开发,有几个方面的原因,

#### 特点

  1. 支持传统多页路由开发(结合php,java等后台语言),也支持单页路由开发(体验更好,如前面gif效果);
  2. 模块化,组件化,支持多人协作;
  3. 动态组件,按需加载;也可变成静态模块一次性加载;
  4. 支持状态管理;
  5. 丰富模板,快速开发;
  6. ...

    作为传统的H5,做一些展示类的没有问题,可一旦涉及到原生底层接口,比如调用蓝牙,陀螺仪等之类的开发,目前无能为力。这种时候有2个选择,BUI可以结合打包平台,如Cordova,Dcloud等,打包成独立安装App。
可是解决了底层能力,如何引流?没人安装,没人用也是个问题啊。

2. 小程序开发

小程序诞生了,免安装,即用即走,既解决了调用底层的能力,又有了低成本的获客渠道。但这玩意又自己搞了个开发语言,如果你之前有上线的产品,想要在小程序里面用,你得重新投入开发一套,开发成本一回事,小程序的特点是小,有很多限制,比方包大小,路由层级限制等。
特点
  1. 免安装,即用即走;
  2. 支持调用底层能力;
  3. 大小限制,整个小程序所有分包大小不超过 8M,单个分包/主包大小不能超过 2M;
  4. 小程序下载文件到本地,资源限制最大文件为50M;
  5. 路由一开始限制5层,目前是10层;
  6. ...

3. 小程序webview混合开发

综合以上各自优点,衍生的第三种开发方式,混合开发,利用小程序的webview能力,大量的存量H5可以被小程序化,近乎完美。
特点
  1. 支持调用部分底层能力;
  2. 路由无限制;
  3. 大小无限制;
  4. https接口;
  5. https业务域名;
  6. 不支持个人小程序(重点)
  7. ...

目前很多互联网大厂也使用webapp结合小程序的开发方式,虽然webview开发有诸多限制,但这种开发方式,可以突破小程序的层级限制,真正的一次开发,多端适配,保持一致体验的同时,降低了开发成本,维护成本。

本文示例采用BUI开发的webapp结合微信小程序webview开发的方案,如果感兴趣,接着往下看。

二、BUI提供的小程序混合Webapp开发方案

利用小程序webview的方案,之前的bui单页分享出去的页面,只能跳到首页,而现在通过这个新的解决方案,可以实现分享的时候,自动把参数带上,用户打开自动跳转到分享的页面,并且把该页面需要到参数一并带上,比如文章详情的id。

该方案包含以下示例:

1.支持分享

  1. 支持跳转传参数给小程序的页面;

  1. 支持后退关闭小程序webview;
  2. 支持发送消息给小程序,需要在用户触发分享后退之类才会触发消息;

  1. 支持关闭所有页面,回到主程序的tab;

  1. ...

三、如何使用?

创建小程序webview目录的工程

buijs create webview -p weixinapp

该方案webview开发包含两个部分,

  1. bui标准工程, 负责bui自身的功能交互, 并且提供了操作微信小程序路由的示例;
  2. /src/weixin目录 为小程序的工程.

小程序工程详细说明

1.目录说明

/src/weixin

比新建的微信小程序工程(2021-4-28 号),多了以下东西

目录文件说明
/bui新增bui的目录,存放bui相关的模块脚本
/bui/webview.jswebapp/index 模块需要用的一些方法,会自动解析URL参数实现分享
/pages/webapp新增 webapp 目录
/pages/webapp/index.js用来配置webapp的url地址
/pages/webapp/index.json页面的相关配置
/pages/webapp/index.wxml相当于html文件
/pages/webapp/index.wxss相当于css文件

如果是在已有的工程要使用bui的webapp,则可以把以上文件,复制到微信小程序工程即可。

2. 小程序使用说明

  1. mp.weixin.com 注册小程序;
  2. 获取小程序到appid 修改 project.config.json

    {
      ...
      "appid": "wx11xxxxxxxxxxxxx",
      "projectname": "bui",
      ...
    }
  3. 导入buiMiniProgram到当前工程
  4. 修改 pages/webapp/index.js webapp的地址为远程的bui单页路由地址
  5. 调试阶段,在微信开发者工具右上角,详情->本地设置->勾选 不校验合法域名、web-view(业务域名)、TLS版本以及https证书

四、常见问题

  1. 如何修改小程序默认首页,比方需要跳转到授权?

答:把 app.json 里面的数组换个位置,小程序默认打开该数组的第一个索引路径。

"pages":[
    "pages/index/index",
    "pages/webapp/index",
  ],
  1. 个人可以使用bui这种开发方式吗?

答:不可以,小程序有较多限制,不允许个人开发者配置web-view 业务域名;

  1. 公司使用bui开发webview小程序,需要提前了解哪些?

答:

  1. 必须要有公司资质,需要申请公司资质的小程序;
  2. 域名必须要备案;
  3. 域名必须是https;
  4. 小程序的相关请求也需要进行配置,也就是你使用第三方的请求,没法校验域名的情况下,是不允许请求的;
  ... 其它参考小程序的官方文档。

五、附录:

  1. bui框架 http://easybui.com
  2. buijs命令行 https://www.npmjs.com/package...
  3. 小程序Webview说明:https://developers.weixin.qq....
  4. 微信JS-SDK: https://developers.weixin.qq....
  5. 微信JS-SDK Demo http://demo.open.weixin.qq.co...

欢迎关注bui神速订阅号,专注webapp开发。


王小o
312 声望61 粉丝

BUI专注webapp快速开发