打通前后端逻辑，客户端Flutter代码一天上线

对于原生的能力的动态化，Android平台各公司都有很完善的动态化方案，甚至Google还提供了Android App Bundles让开发者们更好地支持动态化。由于Apple官方担忧动态化的风险，因此并不太支持动态化。因此动态化能力就会考虑跟Web结合，从一开始基于 WebView 的 Hybrid 方案，到现在与原生相结合的 React Native 、Weex。

与此同时，随着闲鱼Flutter技术的推广，已经有10多个页面用Flutter实现，上面提到的几种方式都不适合Flutter场景，如何解决这个问题Flutter的动态化的问题？

我们最初调研了Google的动态化方案CodePush。

CodePush是谷歌官方的动态化方案，Dart VM在执行的时候，加载 isolate_snapshot_data 和 isolate_snapshot_instr 2个文件，通过动态更改这些文件，就达到动态更新的目的。官方的Flutter源码当中，已经有相关的提交来做动态更新的内容，具体可以参考 ResourceExtractor.java。目前，此功能还在开发中，期待ing。

动态模板，就是通过定义一套DSL，在端侧解析动态的创建View来实现动态化，比如LuaViewSDK、Tangram-iOS和Tangram-Android。这些方案都是创建的Native的View，如果想在Flutter里面实现，需要创建Texture来桥接；Native端渲染完成之后，再将纹理贴在Flutter的容器里面，实现成本很高，性能也有待商榷，不适合闲鱼的场景。

所以我们提出了闲鱼自己的Flutter动态化方案，前面已经有同事介绍过方案的原理：《做了2个多月的设计和编码，我梳理了Flutter动态化的方案对比及最佳实现》，下面看下具体的实现细节。

先来看下一个完整的模板文件，以新版我的页面为例，这个是一个列表结构，每个区块都是一个独立的Widget，现在我们期望将“卖在闲鱼”这个区块动态渲染，对这个区块拆分之后，需要3个子控件：头部、菜单栏、提示栏；因为这3部分界面有些逻辑处理，所以先把他们的逻辑内置。

内置的子控件分别是 MenuTitleWidget、 MenuItemWidget和 HintItemWidget，编写的模板如下：

@overrideWidget build(BuildContext context) {    return new Container(        child: new Column(            children: <Widget>[                new MenuTitleWidget(data),    // 头部                new Column(    // 菜单栏                    children: <Widget>[                        new Row(                            children: <Widget>[                                new MenuItemWidget(data.menus[0]),                                new MenuItemWidget(data.menus[1]),                                new MenuItemWidget(data.menus[2]),                            ],                        )                    ],                ),                new Container(    // 提示栏                    child: new HintItemWidget(data.hints[0])),            ],        ),    );}

中间省略了样式描述，可以看到写模板文件就跟普通的widget写法一样，但是有几点要注意：

1. 每个Widget都需要用 new或 const来修饰

2. 数据访问以 data开头，数组形式以 []访问，字典形式以 .访问

模板写好之后，就要考虑怎么在端上渲染，早期版本是直接在端侧解析文件，但是考虑到性能和稳定性，还是放在前期先编译好，然后下发到端侧。

编译模板就要用到Dart的 Analyzer库，通过 parseCompilationUnit函数直接将Dart源码解析成为以 CompilationUnit为Root节点的AST树中，它包含了Dart源文件的语法和语义信息。接下来的目标就是将 CompilationUnit转换成为一个JSON格式。

上面的模板解析出来build函数孩子节点是 ReturnStatementImpl，它又包含了一个子节点 InstanceCreationExpressionImpl，对应模板里面的 newContainer(…)，它的孩子节点中，我们最关心的就是 ConstructorNameImpl和 ArgumentListImpl节点。 ConstructorNameImpl标识创建节点的名称， ArgumentListImpl标识创建参数，参数包含了参数列表和变量参数。

定义如下结构体，来存储这些信息：

class ConstructorNode {    // 创建节点的名称    String constructorName;    // 参数列表    List<dynamic> argumentsList = <dynamic>[];    // 变量参数    Map<String, dynamic> arguments = <String, dynamic>{};}

递归遍历整棵树，就可以得到一个 ConstructorNode树，以下代码是解析单个Node的参数：

ArgumentList argumentList = astNode;

for (Expression exp in argumentList.arguments) {
    if (exp is NamedExpression) {
        NamedExpression namedExp = exp;
        final String name = ASTUtils.getNodeString(namedExp.name);
        if (name == 'children') {
            continue;
        }

        /// 是函数
        if (namedExp.expression is FunctionExpression) {
            currentNode.arguments[name] =
                FunctionExpressionParser.parse(namedExp.expression);
        } else {
            /// 不是函数
            currentNode.arguments[name] =
                ASTUtils.getNodeString(namedExp.expression);
        }
    } else if (exp is PropertyAccess) {
        PropertyAccess propertyAccess = exp;
        final String name = ASTUtils.getNodeString(propertyAccess);
        currentNode.argumentsList.add(name);
    } else if (exp is StringInterpolation) {
        StringInterpolation stringInterpolation = exp;
        final String name = ASTUtils.getNodeString(stringInterpolation);
        currentNode.argumentsList.add(name);
    } else if (exp is IntegerLiteral) {
        final IntegerLiteral integerLiteral = exp;
        currentNode.argumentsList.add(integerLiteral.value);
    } else {
        final String name = ASTUtils.getNodeString(exp);
        currentNode.argumentsList.add(name);
    }
}

端侧拿到这个 ConstructorNode节点树之后，就可以根据Widget的名称和参数，来生成一棵Widget树。

工作流程：

1. 开发人员编写dart文件，编译上传到CDN

2. 端侧拿到模板列表，并在端侧存库

3. 业务方直接下发对应的模板id和模板数据

4. Flutter侧再通过桥接获取到模板，并创建Widget树

对于Native测，主要负责模板的管理，通过桥接输出到Flutter侧。

程序启动的时候，会先获取模板列表，业务方需要自己实现，Native层获取到模板列表会先存储在本地数据库中。Flutter侧业务代码用到模板的时候，再通过桥接获取模板信息，就是我们前面提到的JSON格式的信息，Flutter也会有缓存，已减少Flutter和Native的交互。

创建每个Widget的过程，就是解析节点中的 argumentsList和 arguments 并做数据绑定。例如，创建 HintItemWidget需要传入提示的数据内容， newHintItemWidget(data.hints[0])，在解析 argumentsList时，会通过key-path的方式从原始数据中解析出特定的值。

解析出来的值都会存储在 WidgetCreateParam里面，当递归遍历每个创建节点，每个widget都可以从 WidgetCreateParam里面解析出需要的参数。

/// 构建widget用的参数class WidgetCreateParam {  String constructorName;    /// 构建的名称  dynamic context;    /// 构建的上下文  Map<String, dynamic> arguments = <String, dynamic>{}; /// 字典参数  List<dynamic> argumentsList = <dynamic>[]; /// 列表参数  dynamic data; /// 原始数据}

通过以上的逻辑，就可以将 ConstructorNode树转换为一棵 Widget树，再交给Flutter Framework去渲染。

至此，我们已经能将模板解析出来，并渲染到界面上，交互事件应该怎么处理？

在写交互的时候，一般都会通过 GestureDector、 InkWell等来处理点击事件。交互事件怎么做动态化？

以 InkWell组件为例，定义它的 onTap函数为 openURL(data.hints[0].href,data.hints[0].params)。在创建 InkWell时，会以 OpenURL作为事件ID，查找对应的处理函数，当用户点击的时候，会解析出对应的参数列表并传递过去，代码如下：

...
final List<dynamic> tList = <dynamic>[];
// 解析出参数列表
exp.argumentsList.forEach((dynamic arg) {
    if (arg is String) {
        final dynamic value = valueFromPath(arg, param.data);
        if (value != null) {
            tList.add(value);
        } else {
            tList.add(arg);
        }
    } else {
        tList.add(arg);
    }
});

// 找到对应的处理函数
final dynamic handler =
    TeslaEventManager.sharedInstance().eventHandler(exp.actionName);
if (handler != null) {
    handler(tList);
}
...

新版我的页面添加了动态化渲染能力之后，如果有需求新添加一种组件类型，就可以直接编译发布模板，服务端下发新的数据内容，就可以渲染出来了；动态化能力有了，大家会关心渲染性能怎么样。

在加了动态加载逻辑之后，已经开放了2个动态卡片，下图是新版本我的页面近半个月的的帧率数据：

从上图可以看到，帧率并没有降低，基本保持在55-60帧左右，后续可以多添加动态的卡片，观察下效果。

注：因为我的页面会有本地的一些业务判断，从其他页面回到我的tab，都会刷新界面，所以帧率会有损耗。

从实现上分析，因为每个卡片，都需要遍历 ConstructorNode树来创建，而且每个构建都需要解析出里面的参数，这块可以做一些优化，比如缓存相同的Widget，只需要映射出数据内容并做数据绑定。

现在监控了渲染的逻辑，如果本地没有对应的Widget创建函数，会主动抛Error。监控数据显示，渲染的流程中，还没有异常的情况，后续还需要对桥接层和native层加错误埋点。

基于Flutter动态模板，之前需要走发版的Flutter需求，都可以来动态化更改。而且以上逻辑都是基于Flutter原生的体系，学习和维护成本都很低，动态的代码也可以快速的沉淀到端侧。

参考文献

1. https://github.com/flutter/flutter/issues/14330

2. https://www.dartlang.org/

3. https://mp.weixin.qq.com/s/4s6MaiuW4VoHr7f0SvuQ

4. https://github.com/flutter/engine

文章作者：景松

文章来源：闲鱼技术微信公众号，欢迎大家前去关注

文章地址：打通前后端逻辑，客户端Flutter代码一天上线