用Vue开发小程序的框架

为什么是 Vue.js?这取决于团队技术栈选型,引入新的选型对统一技术栈和提高开发效率相悖,有违开发工具服务业务的初衷。

mpVue 的演进

mpVue 的形成,来源于业务场景和需求,*终方案的确定,经历了三个阶段。

  • *阶段:我们实现了一个视图层代码转换工具,旨在提高代码首次开发效率。通过将 H5 视图层代码转换为小程序代码,包括 HTML 标签映射、Vue.js 模板和样式转换,在此目标代码上进行二次开发。我们做到了有限的代码复用,但组件化开发和小程序学习成本并未得到有效改善。
  • 第二阶段:我们着眼于完善代码组件化机制。参照 Vue.js 组件规范设计了代码组织形式,通过代码转换工具将代码解析为小程序。转换工具主要解决组件间数据同步、生命周期关联和命名空间问题。*终我们实现了一个 Vue.js 语法子集,但想要实现更多特性或跟随 Vue.js 版本迭代,工作量变得难以估计,有永无止境之感。
  • 第三阶段:我们的目标是实现对 Vue.js 语法全集的支持,达到使用 Vue.js 开发小程序的目的。并通过引入 Vue.js RunTime 实现了对 Vue.js 语法的支持,从而避免了人肉语法适配。至此,我们完成了使用 Vue.js 开发小程序的目的。较好地实现了技术栈统一、组件化开发、多端代码复用、降低学习成本和提高开发效率的目标。

mpVue 设计思路

Vue.js 和小程序都是典型的逻辑视图层框架,逻辑层和视图层之间的工作方式为:数据变更驱动视图更新;视图交互触发事件,事件响应函数修改数据再次触发视图更新,如图 1 所示。

%title插图%num

图 1 小程序实现原理

鉴于 Vue.js 和小程序一致的工作原理,我们思考将小程序的功能托管给 Vue.js,在正确的时机将数据变更同步到小程序,从而达到开发小程序的目的。这样,我们可以将精力聚焦在 Vue.js 上,参照 Vue.js 编写与之对应的小程序代码,小程序负责视图层展示,所有业务和逻辑收敛到 Vue.js 中,Vue.js 数据变更后同步到小程序,如图 2 所示。如此一来,我们就获得了以 Vue.js 的方式开发小程序的能力。为此,我们设计的方案如下:

%title插图%num

图 2 mpVue 实现原理

Vue 代码:

  1. 将小程序页面编写为 Vue.js 实现;
  2. 以 Vue.js 开发规范实现父子组件关联。

小程序代码:

  1. 以小程序开发规范编写视图层模板;
  2. 配置生命周期函数,关联数据更新调用;
  3. 将 Vue.js 数据映射为小程序数据模型。

并在此基础上,附加如下机制:

  1. Vue 实例与小程序 Page 实例建立关联;
  2. 小程序和 Vue 生命周期建立映射关系,能在小程序生命周期中触发 Vue 生命周期;
  3. 小程序事件建立代理机制,在事件代理函数中触发与之对应的 Vue 组件事件响应。

这套机制总结起来非常简单,但实现却相当复杂。在揭秘具体实现之前,读者可能会有这样一些疑问:

  1. 要同时维护 Vue.js 和小程序,是否需要写两个版本的代码实现?
  2. 小程序负责视图层展现,Vue.js 的视图层是否还需要,如果不需要应该如何处理?
  3. 生命周期如何打通,数据同步更新如何实现?

上述问题包含了 mpVue 框架的核心内容,下文将仔细为你道来。首先,mpVue 为提高效率而生,本身提供了自动生成小程序代码的能力,小程序代码根据 Vue.js 代码构建得到,并不需要同时开发两套代码。

Vue.js 视图层渲染由 Render 方法完成,同时在内存中维护着一份虚拟 DOM,mpVue 无需使用 Vue.js 完成视图层渲染,因此我们改造了 Render 方法,禁止视图层渲染。熟悉源代码的读者都知道 Vue RunTime 有多个平台的实现,除了我们常见的 Web 平台,还有 Weex。从现在开始,我们增加了新的平台 mpVue。

再看第三个问题,生命周期和数据同步是 mpVue 框架的灵魂,Vue.js 和小程序的数据彼此隔离,各自有不同的更新机制。mpVue 从生命周期和事件回调函数切入,在 Vue.js 触发数据更新时实现数据同步。小程序通过视图层呈现给用户、通过事件响应用户交互,Vue.js 在后台维护着数据变更和逻辑。可以看到,数据更新发端于小程序,处理自 Vue.js,Vue.js 数据变更后再同步到小程序。为实现数据同步,mpVue 修改了 Vue.js RunTime 实现,在 Vue.js 的生命周期中增加了更新小程序数据的逻辑。

而用户交互触发的数据更新则是通过事件代理机制完成。在 Vue.js 代码中,事件响应函数对应到组件的 method 方法,Vue.js 自动维护了上下文环境。然而在小程序中并没有类似的机制,又因为 Vue.js 执行环境中维护着一份实时的虚拟 DOM,这与小程序的视图层完全对应。我们思考,在小程序组件节点上触发事件后,只要找到虚拟 DOM 上对应的节点,触发对应的事件不就完成了么。Vue.js 事件响应如果触发了数据更新,其生命周期函数更新将自动触发,在此函数上同步更新小程序数据,数据同步就实现了。

mpVue 如何使用

mpVue 框架本身由多个 npm 模块构成,入口模块已经处理好依赖关系,开发者只需要执行如下代码即可完成本地项目创建。

安装 vue-cli

$ npm install –global vue-cli

根据模板项目创建本地项目,目前为内网地址,暂稳开放

$ vue init ‘bitbucket:xxx.meituan.com:hfe/mpvue-quickstart’ –clone my-project

安装依赖和启动自动构建

$ cd my-project

$ npm install

$ npm run dev

执行完上述命令,在当前项目的 dist 子目录将构建出小程序目标代码,使用小程序开发者工具载入 dist 目录即可启动本地调试和预览。

示例项目遵循 Vue.js 模板项目规范,通过 Vue.js 命令行工具 vue-cli 创建。代码组织形式与 Vue.js 官方实例保持一致,我们为小程序定制了 Vue.js RunTime 和 Webpack 加载器,此部分依赖也已经内置到项目中。

针对小程序开发中常见的两类代码复用场景,mpVue 框架为开发者提供了解决思路和技术支持,开发者只需要在此指导下进行项目配置和改造。

将小程序转换为 H5

直接使用 Vue.js 规范开发小程序,代码本身与 H5 并无不同,具体代码差异会集中在平台 API 部分。此外无需明显改动,改造主要分以下几个部分:

  1. 将小程序平台的 Vue.js 框架替换为标准 Vue.js;
  2. 将小程序平台的 Vue-loader 加载器替换为标准 Vue-loader;
  3. 适配和改造小程序与 H5 的底层 API 差异。

将 H5 转换为小程序

已经使用 Vue.js 开发完 H5,则需要完成以下事宜:

  1. 将标准 Vue.js 替换为小程序平台的 Vue.js 框架;
  2. 将标准 Vue-loader 加载器替换为小程序平台的 Vue-loader;
  3. 适配和改造小程序与 H5 的底层 API 差异。

根据小程序开发平台提供的能力,我们*大程度地支持了 Vue.js 语法特性,但部分功能现阶段暂时尚未实现,具体见表 1。

%title插图%num

表 1 mpVue 暂不支持的语法特性

mpVue 框架的目标是将小程序和 H5 的开发方式通过 Vue.js 建立关联,达到*大程度的代码复用。但由于平台差异的客观存在(主要集中在实现机制、底层 API 能力差异),我们无法做到代码 100%复用,平台差异部分的改造成本无法避免。对于代码复用的场景,开发者需要重点思考如下问题并做好准备:

  1. 尽量使用平台无的语法特性,这部分特性无需转换和适配成本;
  2. 避免使用不支持的语法特性,譬如 slot、filter 等,降低改造成本;
  3. 如果使用特定平台 API,考虑抽象好适配层接口,通过切换底层实现完成平台转换。

mpVue *佳实践

在表 2 中,我们对微信小程序、mpVue、WePY 这三个开发框架的主要能力和特点做了横向对比,帮助大家了解不同框架的侧重点,结合业务场景和开发习惯,确定技术方案。对于如何更好地使用 mpVue 进行小程序开发,我们总结了一些*佳实践。

%title插图%num

表 2 框架主要能力及特性对比

  1. 使用 vue-cli 命令行工具创建项目,使用 Vue 2.x 的语法规范进行开发;
  2. 避免使用不框架不支持的语法特性,即有部分 Vue.js 语法在小程序中无法使用,尽量 mpVue 和 Vue.js 共有特性;
  3. 合理设计数据模型,对数据的更新和操作做到细粒度控制,避免性能问题;
  4. 合理使用组件化开发小程序,提高代码复用。

结语

mpVue 框架已经在业务项目中得到实践和验证,目前开发文档也已经就绪,正在做开源前的*后准备,希望能够为小程序和 Vue.js 生态贡献一份力量。mpVue 的初衷是希望让 Vue.js 的开发者以低成本接入小程序开发,其能力和使用体验还有待进一步的检验。我们未来会继续扩展现有功能、解决用户的问题和需求、优化开发体验、完善周边生态建设,以帮助到更多的开发者。

需要说明一下,mpVue 是通过 fork Vue.js 源码进行二次开发,新增加了 mp 平台的 Vue.js 实现,我们保留了跟随 Vue.js 版本升级的能力,希望未来能够实现更好的能力增强,*后感谢 Vue.js 框架和微信小程序对业界带来的便利