微信小程序内嵌网页的一些(最佳)实践

时间:2021-02-09 19:38:51

前言

3 个月前,微信小程序推出了 web-view 组件引发了一波小高潮,笔者所在的大前端团队写过一篇浅析,详情可见:浅谈微信小程序前端生态

我们曾大胆猜想,这一功能,可能直接导致小程序数量增长迎来一波高峰。

毕竟磨刀霍霍却一直资源不足的团队应该不少,现在可以把已有 H5 应用嵌入到小程序 web-view 容器中,以最低的开发成本坐蹭微信流量红利,何乐而不为呢?

我们也曾畅想也许“小程序页面+ web 页”混合开发(甚至 web 更重)会成为以后的新趋势。

2M 代码限制(如今已更新至 4M)使得像“转转官方”这样功能繁复的小程序必须考虑引入 web 内容,再有就是小程序审核发布机制使得它终究不能像 web 一样迭代迅速。

正好笔者所在的业务线,存在已有的 H5 应用却无对应小程序的情况。我们在开发对应小程序时也算收获了不少经验(踩了不少坑),分享给有小程序需求的朋友们~

最大的坑:不支持服务通知

是的,web-view 不支持推送服务通知(或称模板消息)。

微信小程序内嵌网页的一些(最佳)实践

如图所示,类似订阅号在对话列表的模式

为什么能称为最大的坑?我们先了解一下服务通知,以下引用全部来自微信官方小程序文档。

基于微信的通知渠道,我们为开发者提供了可以高效触达用户的模板消息能力,以便实现服务闭环并提供更佳的体验。

看起来很厉害,如果咱们的小程序没这个功能会怎样?

  1. “用完即走”是小程序的口号,没有服务通知代表失去了高效触达(召回)用户的能力,然后用户就再也回不来了,促活和留存怎么办?

  2. 很多功能不是像订阅号里看篇文章一样,几分钟就能搞定的,比如绝大部分电商的行为:从搜索、浏览比价、跟卖家交流,到加入购物车仅仅是走完了不到一半的生命周期;然后才是下单支付评价,还不包括推荐复购取消退款等等,没个15-30分钟哪里够。然而,没有用户会一直开着某个小程序,别人还要切出去聊天刷朋友圈呢。没有了化同步为异步的能力,绝大部分产品逻辑如何实现服务闭环?

一篇教你突破小程序模板消息推送限制的文章中,也总结了服务通知的「多、快、好、省」等特点。这些先不展开,我们还能看到:

  1. 该小程序近 30 天访问来源数据显示,有 20% 左右的用户通过模板消息进入小打卡,在各种来源中排名第 3 位(如果分母去掉新用户的来源,比率和排名会更高);

  2. 况且,用户基本都不会关闭微信的消息推送,相较 App 的推送和短信推送来说,小程序的推送触达率会高很多。

so,没有哪个(正经的)小程序会不支持服务通知(流氓些的比如拼多多,看了个商品能给你连着推 N 条)。试想一下没有推送通知的 APP,你的产品、运营和老板们会同意么?

为什么不支持

然而,为什么 web-view 不支持服务通知?哪里坑了?还请继续看微信官方文档里的定义。

下发条件:用户本人在微信体系内与页面有交互行为后触发

总结起来就是,支付3条、提交表单(该表单需声明为要发模板消息)1条,7天有效。

  1. 首先,这里区别了支付和提交表单两种行为,要分不同的情况上报,开始了看到没…

  2. 然后,web-view 不支持支付能力(其 JSAPI 能力不包含微信支付),这个在微信的文档里没有显式的声明,不过能在微信的 web-view 问题汇总中看到,这个也挺坑的…

  3. 其实,支付行为对小程序本身而言只是极少数的交互,大多数小程序甚至不含支付。所以我们基本还得靠表单,可问题就出在这:小程序的 web-view 和表单(form 组件) 不兼容!!!

PS:我们先区分下 form 组件,它跟 web-view 内网页的表单(form 标签)没有任何关系。

PS:RN 和 Weex 也没有 form 组件。为什么笔者一看到 form 就想到如下的图?

微信小程序内嵌网页的一些(最佳)实践

1999年12月发布的 HTML 4.01 Specification 就支持了 form,自 AJAX 在2005年风靡世界后,跨域、文件上传都有了 form 之外的解决方案,谁没事还用这玩意?

先不吐槽微信文档里 form 组件的定义是有多简陋,再看其 web-view 组件的定义~

web-view 组件是一个可以用来承载网页的容器,会自动铺满整个小程序页面。

何止铺满,尝试把 web-view 放在 form 组件内,form 组件都铺没了。so,自动铺满 = 页面独占 = 所有其他元素都被直接覆盖…好吧,别人在文档最下方的 Bug & Tip 里写了行小字~

综上,web-view 跟服务通知已绝缘。so,小程序里网页的交互行为不算在微信体系内!!?

我不禁回想起 Google 之前推出的 PWA(Progressive Web App),在这又有那么一丝神似。

  1. 两者同是基于 Web 的技术,开发出(或许)可替代 APP 的伪原生应用;

  2. PWA 的推送通知因其 API 太超前和一些不知名的服务被和谐用不了(你懂的);

  3. 小程序的服务通知嘛,你要想用 web-view 做壳就发布上线也用不了。

扯远了点,但大家都说:PWA 是引领下一代潮流的 Web 技术超集,而小程序是对 Web 技术进行修(阉割)补(Hack)的(黑)魔法…

不做展开,欢迎移步:如何客观地评价「小程序」的体验? Web 在继续离我们远去

那怎么办?

由于笔者团队的业务对服务通知与支付有大量依赖,那么我们就要彻底放弃 web-view,把之前的 H5 应用全部重写至原生小程序了么?显然不是。

正如前文所说,支付仅是电商诸多环节中的一环,主要在商品 or 订单详情页(这些必须重写)。关于服务通知,通过几个重写后的原生小程序页,也能收集到足够的 form。

  • 具体如何重写,可参考我们之前的像 Vue 一样写微信小程序-深入研究 wepy 框架。虽然 wepy 框架尝试从语法层面尽可能做到与 vue 技术栈的 web 项目同构,但是两端特性 API 兼容依旧是个棘手问题,而且毕竟两者的语法糖和生命周期函数都不一样。这里还有不少人工成本及学习与适应的过程,贴一个例子:

微信小程序内嵌网页的一些(最佳)实践

基于 wepy,模板部分就是个替换+适配的活,JS 麻烦些。离同构差距不小,美团您的 mpVue 呢?

  • 具体如何收集,可参考教你突破小程序模板消息的推送限制这篇文章的做法。也如文章所说,一般大家都会在小程序页中,**把所有能点击的地方都换成 form。**如果觉得不够简单粗暴,也能在 form 中多层嵌套 form,然后让点击事件冒泡的方式来做!(谁让此 form 非彼 form 呢…够魔法么…)

剩下的业务,理论上都可以用 web-view 来实现!!!运营活动页就不说了,开放 web-view 能力最大的优势就是方便了这类需求。小程序首页,甚至配置了 tabBar 的小程序页都可以。因为我们还发现一个神奇的 feature…

微信小程序内嵌网页的一些(最佳)实践

大概是用了原生的 UITabBar,web-view 和 tabBar 能共存

总结

亏了 web-view 组件的及时推出,我们只需重写部分详情页和其依赖的组件,最后复盘一下。

  1. 定位:小程序的 web-view 就像是 Hybrid 客户端嵌 H5 页一样,需要一些基础能力的时候,比如支付、服务通知(IM 和召回等场景)等等,最好使用原生小程序;

  2. 兼容性:这个无须过多担心,最新的基础库统计数据,1.6.4+ 的覆盖率已达 95% 以上;

  3. 数据通信:小程序 => web-view 可以在 url 中用 search、hash 的方式,web-view => 小程序可用 bindmessage,一般用来解决分享信息传递的问题;

  4. 登录:a. web-view 内走微信授权,b. 小程序登录后再进入 web-view,并把相关 cookie 通过 url 传递给 web-view。

其它 feature(欢迎讨论和补充):

  1. web-view 跟小程序是独立的两个环境,数据完全不通,包括 cookie、session、localStorage 等等;

  2. 但小程序内嵌 web-view 跟微信内置浏览器是一套环境,也就是说你在 web-view 里面留下的以上痕迹,到微信里内置浏览器打开也有;

  3. 在两种环境下,不太容易区分到底是什么环境,小程序官方给的判断方法是 window.__wxjs_environment === 'miniprogram',但是在 web-view 进入第二页时候,安卓机下这个变量就 undefined 了。

其它的坑(常见错误):

  1. 打开的域名没有在小程序管理后台设置业务域名(注意是业务域名,不是服务器域名);

  2. 打开的页面 302 过去的地址也必须设置过业务域名;

  3. 页面可以包含 iframe,但是 iframe 的地址必须为业务域名;

  4. 打开的页面必须为 https 服务;

  5. 开发者自己检查自己的 https 服务是否正常,测试方法:普通浏览器打开对应的地址; 等等,详情请移步 web-view 问题汇总(https://developers.weixin.qq.com/blogdetail?action=get_post_info&lang=zh_CN&token=585555149&docid=ebfd9e5ec9986b4f23c41f8d8bbf2730)查阅,或在该帖子里留言。