京东:将Flutter扩展到微信小程序端的探索
作者|严康 京东 ARES编辑|王文婧ARES 作为京东技术中台的多端融合技术团队,聚焦于跨端开发技术框架和平台搭建,包括但不限于 RN、Flutter、小程序等技术栈。目前已经广泛应用于京东商城、京东金融、京东到家、京东拼购等京东 La 系核心 APP 内,帮助业务团队低成本、快速开发自己的业务,以应对市场的瞬息万变之势。
Google Flutter 是一个非常优秀的跨端框架,不仅可以运行在 Android、 iOS 平台,而且可以支持 Web 和桌面应用。在国内小程序是非常重要的技术平台,我们也一直思考能否把 Flutter 扩展到小程序端?我们团队之前已经开源了 Alita 项目,Alita 可以把 React Native 的代码转换并运行在微信小程序平台。受此启发,我们认为同样是声明式 UI 框架的 Flutter 同样可以运行在小程序平台。
所以,我们发起了 Flutter_mp 开源项目。以微信小程序为例,不过现阶段,Flutter_mp 项目还处于早期的实验阶段,很多功能还在探索规划中,欢迎大家在 Github 上随时关注我们的最新进展,或者参与项目共同探索。
原理简介虽然还有诸多功能未完成,我们先来谈谈整个Flutter_mp的实现原理。篇幅原因,下面我们将只对Flutter_mp几个重要的部分进行简单说明。
Flutter 版官方 layout 样例
声明式 UI 的处理Flutter是声明式 UI 框架,声明式 UI 只需要向框架描述 UI 长什么样子而不用关心框架具体的实现细节,具体到Flutter,上层的 UI 描述使用底层的 skia 图形引擎处理就是原生Flutter,而把底层处理换成 html/css/canvas 就是Flutter_web,而Flutter_mp则是探索在类小程序上对这些 UI 描述的处理。
我们看一个最简单例子:var x = 'Hello World'
Center(
child: Text(x)
);
对于上面的 UI 结构,我们只需要在小程序的 wxml 文件里,用如下的结构对应就 OK 了。// wxml 部分
<Center>
<Text>{{x}}</Text>
</Center>
// js 部分
Component({
data: {
x: 'Hello World'
}
})
虽然实际的结构要比上面的情况复杂的多,不过通过上面简单的例子,我们知道起码要做两个事情:wxml 结构生成我们知道小程序是无法动态操作节点的,wxml 结构需要预先生成,所以Flutter运行在小程序之前,会存在一个编译打包阶段,这个阶段会遍历 Dart 代码,根据一定规则生成 wxml 文件(编译阶段还会做下文将要提到的另外一个重要事情 --- 把 Dart 编译为 js)。
具体的,我们首先会将 Dart 源码处理为可分析的 AST 结构,AST 是源代码的树型表示结构。然后我们深度遍历这份 AST 语法树结构,生成目标 wxml,整个过程如下:
构建 wxml 结构的难点在于:Flutter 不仅是声明式 UI 还是“值 UI”,什么叫“值 UI”?简单来说,Flutter 把 UI 看成是一个普通的值,类似于字符串,数字一样的值,既然是一个普通的值,就可以参与所有的控制流程,可以是函数的返回值也可以是函数参数等等。而小程序的 wxml 虽然也是声明式 UI,却不是“值 UI”,wxml 更加像模版,更加的静态。怎么用静态的 wxml 表达动态的“值 UI”是构建 wxml 结构的关键所在。
看个例子:Widget getX() {
if (condition1) {
return Text('Hello');
} else if (condition2) {
return Container(
child: ...
);
} else if (condition3) {
return Center(
child: ...
);
}
...
}
Widget x = getX();
Center(
child: x // < --- 如何处理这里的 x??
);
这里的 child: x,x 是一个动态值,它的具体值需要在运行阶段才能确定,它可能是任意的 Widget,如何在静态的 wxml 上处理这里动态的 x?受 Alita 框架的启发,这里主要是借助于小程序 template 的动态性(template 的 is 属性可以接受变量值)。有如下几步:- 首先在遍历 Dart 源码 AST 结构的时候,会把每一个独立完整的“UI 值”片段,对应到 wxml 的 template, 比如上文 getX 里面的 UI。
<template name="template001">
<text>Hello</text>
</template>
<template name="template002">
<Container>...</Container>
</template>
<template name="template003">
<Center>...</Center>
</template>
<template name="template004">
<Center>
<template is="{{templateName}}" data="{{...templateData}}"/>
</Center>
<template name="template003">
在运行阶段,会根据 getX 函数的运行结果来决定 x 映射的“UI 值”,如果 getX 里面 condition1 为 true,那么这里的 templateName 的值就是 template001。具体的数据计算收集工作,参考下面的 “渲染数据收集”过程。
可以看出 Flutter_mp 处理“值 UI”方式,完全参考了 Alita。
渲染数据收集wxml 结构的生成是在编译阶段就完成了,与它不同渲染数据是运行时的信息,随时会根据 setState 而改变。那么我们怎么收集出我们需要的渲染数据呢?
如果我们还是顺着 Flutter 的架构图,很难插入我们收集的钩子函数,另外 Flutter 的这个架构对于小程序来说太重了,下图红框里的这些过程对于小程序的渲染来说并不必要。最后由于最终的代码会被转化为 js,而 Flutter 本身依赖的库里面很多是不支持转化 js 的,比如 dart:ui 等等。
所以我们实现了一个极简极简的 Flutter 小程序版本 mini_Flutter,在编译期我们会把所有对 Flutter 库的引用替换为 mini_Flutter, mini_Flutter 只存在到上图的 Rendering 阶段,这个 Rendering 的实现也是为小程序定制的, 在运行时期 Rendering 不断收集 Widgets 的信息。最终生成一个 UI 描述的 JSON 结构,这个结构就包含了上文所说的 templateName , templateData,UI 描述将会被下层小程序获得,用来渲染小程序 UI,架构图如下:
Dart/JS:转化与互操作Flutter的开发语言是 Dart,而小程序的运行环境是浏览器,所以我们还需要把 Dart 编译为 JavaScript 代码。
在上文的编译打包阶段也提到这一点,这个过程主要是使用了 Dart 提供的 dart2js 工具,不过,针对小程序环境,生成的 js 代码仍需要做一些适配,另外虽然都是 JS 代码,dart2js 生成的 js 和小程序原生 js 的运行环境却是隔离的,也就是说它们是不能共享变量,方法等等,它们各自在本身的"域"里执行。
这带来两个问题:总结一下:Dart(最终会编译为 JS)与小程序原生 JS 如何互操作?
解决这个问题主要是借助 dart:js, package:js 这两个库:
Dart 操作 JS:import 'package:js/js.dart';
@JS("JSON.stringify")
external stringify(String str);
这样当 Dart 代码调用 stringify 方法的时候,实际上会执行window.JSON.stringify
方法。
// dart 注册
void main() {
context['dartHi'] = () {
print('dart hi!');
};
}
// js 调用
window.dartHi()
这里只是简单说明 Dart 与 JS 的互操作,另外由于小程序的运行环境是阉割以后的浏览器环境,Flutter_mp的实现还稍有不同。
总之,Dart 与 JS 是可以互操作的,这样就打通了上层Flutter环境和下层小程序环境。
布局系统Flutter的布局系统不同与 css,但是和 css 颇相似。
在上文提到的 Rendering 阶段,会根据 Widget 的布局属性、类别、约束条件生成一个等效的 css 样式。注意,这里边界约束是上下文相关的。比如一个没有宽高的 Container 实际大小,不仅和子元素相关,还和父元素传递过来的边界约束条件相关,这个其实是比较麻烦的,能不能把 Flutter 的 Widget 属性,边界约束完全用 css 表达,我们还在寻求有效的方案。
总结和Flutter_web一样,完全把Flutter所有特性渲染到小程序上是不可能的,一般我们觉得应该是部分页面,部分功能需要运行在小程序上,这样使用Flutter_mp才是有意义的。
正如前文所说,Flutter_mp还在很早期的阶段,社区的支持和反馈对我们来说特别宝贵。同时欢迎广大开发者一起来维护Flutter_mp。
Flutter_mp: https://github.com/areslabs/Flutter_mp
如果你需要在生产环境实现小程序跨端开发,推荐使用我们成熟的 RN 转小程序项目 Alita。
Alita:https://github.com/areslabs/alita
课程推荐Java 工程师除了 Java 语法,还需要哪些知识?点亮 Java 开发技能树,全面掌握:设计模式、流行框架、组件和工具、分布式架构、微服务、性能优化。清除能力短板,突破进阶关口。点击「阅读原文」或扫描「下图二维码」了解 Java 工程师的学习路径。