本文要点：

• 了解京东零售云mPaaS中Flutter的热重载原理，有利于日常开发中高效排查问题;
• 掌握如何调试断点Flutter工具链源码;

一、前言

1.1 热重载是什么?

熟悉JS的同学，可能会嗤之以鼻，在N年前就已经用上热重载了，但是对客户端开发人员来说，简直是福音。

那先来看下Flutter官方的定义：

• Flutter’s hot reload feature helps you quickly and easily experiment, build UIs, add features, and fix bugs. Hot reload works by injecting updated source code files into the running
• Dart Virtual Machine (VM). After the VM updates classes with the new versions of fields and functions, the Flutter framework automatically rebuilds the widget tree,
• allowing you to quickly view the effects of your changes.

简单来说，就是通过将修改后的源代码文件注入到正在运行的 Dart 虚拟机来实现，注入之后， Flutter 会自动重新构建 widget 树。

1.2 为什么需要热重载?

程序猿在刀耕火种的时代，开发调试是这样子的：

当项目不大，人数不多的情况下，画面是非常和谐的，效率也是毋庸置疑的高效。但现实是，在大公司，项目往往很大，编译巨慢无比，同时开发人员众多，有着非常严格的流程制度，导致看起来本没有问题的开发调试流程，变得异常的痛苦，降低了个体的效率，这里强调下，指的是个体的效率，个人认为越是完善的流程体系，对个体的约束往往越强，但从团队的角度去看待效率，一定是能 1+ 1 大于 2 的。

而此时的心情是这样子的：

而有了热重载，开发调试是这样子的：

心情也就成这样子的：

1.3 抛出问题

从热重载定义来看，不少人脑子里蹦出不少跟我一样的疑惑：

• 怎么知道哪个文件被修改?
• 修改的源代码到底被转成什么?
• 修改的源代码是怎么注入到Dart虚拟机的?
• Flutter框架又是怎么触发widget重绘的?

同时在日常使用热重载的过程中，也会碰到不少这样那样的疑惑：

• 为什么运行flutter attach后还需要手动输入r来热重载?
• 手动敲r，这么无(gou)语(shi)的设计，我们能做成自动化吗?

当你在网上看过大量热重载文章后，又衍生了额外的问题：

• 尝试去探索源码时，case太多，怎么能模拟真实环境?能否断点调试Flutter源码?
• 热重载看着跟动态化很像，那能否运用在动态化技术上?

不急，本文会对上述疑问进行一一解答。

二、dart的热重载

由于Flutter采用dart作为开发语言，我们先从dart角度来验证下热重载。

2.1 编写验证demo

考虑到dart执行完会关闭当前进程，我们写了个定时器来保证进程存活，同时能看到热重载效果。

2.2 开启VMService

终端下执行 dart --enable-vm-service main.dart，其中的main.dart为2.1中代码文件：

可以看到终端会不断输出"Hello JDFlutter"的字符。

2.3 执行热重载

我们将main.dart文件中打印日志修改为”Hello JD”，同时打开终端输出的Observatory链接地址，如下：

找到我们main.dart的Isolate(读者可以简单理解为是dart中的线程，只不过Isolate没有共享内存)，图中红圈部分，进入后找到Reload Source：

点击Reload Source后，终端开始输出”Hello JD”的字符，完成了一次热重载过程，如下图：

2.4 自动化热重载

还是以上面为例子基础例子，我们加入文件监听，并且通过发送消息给vm_service来实现热重载，代码如下：

直接运行 dart --enable-vm-service main.dart，期间修改”Hello JDFlutter”为”Hello JD”，运行结果如下：

可以看出，我们成功实现了自动化热重载，上述代码跟Dart虚拟机通信步骤如下：

• 获取Dart VM的websocket服务URI
• 通过URI连接上Dart VM的service
• 通过service获取Dart VM
• 通过Dart VM获取isolateId
• 通过service重载指定isolateId的任务

2.5 Dart虚拟机可做的事情

到这里，大家可以放飞自我，Dart Service提供了大量对外协议，包含断点、获取虚拟机状态，性能等协议，可以参考：Dart虚拟机服务接口。

三、Flutter的热重载

Flutter的热重载，本质是在封装dart热重载并且对不同的设备启动安装加载等流程，接下来准备好在Flutter源码世界里翱翔吧，以下分析基于v1.22.5分支的源码。

俗话说，工欲善其事必先利其器，在源码翱翔久了，容易迷茫，找不到东西南北，看到关键方法，又不知道是不是代码真实的case，需要能验证我们的想法，最简单的办法打断点，有针对性的去看源码。

3.1 IDE断点

Flutter源码的下载也很简单，这里就不赘述了，大家可以上网搜下。Flutter工具链的源码位于packages/flutter_tools下。

本文是通过Android Studio(比较熟)来配置和查看源码，配置如下：

• 第一步，先新建一个运行配置，选Dart Command Line App;
• 第二步，找到Flutter源码中工具链的入口文件，flutter_tools.dart;
• 第三步，输入想运行的命令;
• 第四步，找到要调试的Flutter工程;

一顿配置下来，就可以用工具链完美的debug指定Flutter工程的源码，接下来就是选好设备，点击debug按钮，如下图：

3.2 整体流程

以下是Flutter热重载流程图：

简述为：

• 代码改动：工具会扫描工程下的文件，通过修改时间来比对哪些文件被修改;
• 首次编译：第一次启动会生成全量app.dill文件;
• 增量编译：对修改的文件编译生成app.dill.incremental.dill增量文件;
• 更新文件：将增量产物推送到设备中;
• UI更新：DartVM收到增量文件后进行合并，并通知Flutter引擎更新UI

整个过程并没有让App重启，从而达到高效开发调试效果。

3.3 源码分析

3.3.1 run命令流程

我们从flutter run命令为入口分析，类位于packages/flutter_tools/lib/executable.dart中的main()方法，run命令最终实现类位于packages/flutter_tools/lib/src/commands/run.dart。

RunCommand在构造函数中默认开启了hot标识，如果需要关闭，要新增入参--no-hot。

从run命令的流程，可以看出，主要是做了默认参数设置，参数校验，flutter设备初始，模式判断等，热重载是从HotRunner.run中开始执行。

3.3.2 热重载流程-首次启动

在HotRunner中，流程也并不复杂：

可以看出，HotRunner做了三件事：

• 对目标设备，编译生成dill文件(有人叫kernel文件，本质是一种中间描述，后文会介绍);
• 对目标设备，安装运行App;
• 对目标设备进行attach，从而开启attach;

第二步会涉及到不同平台不同做法，对iOS和Android来说，分别对应xcrun和adb，不是本文重点，流程也比较长，以后有机会再展开讲，重点说第一步和第三步。

编译生成dill文件

最终调用到_compile方法，代码太过于繁琐，我们直接断点看，如下：

从断点信息可以获知，dart文件会被转为kernel文件app.dill，以下截取部分app.dill内容，可以看出app.dill是一份完整的代码文件，包含了main.dart的内容，右边为main.dart源文件，左边为app.dill文件内容：

生成的app.dill是一份全量的代码，接下来编译不同设备(Android、iOS)的安装包，同时运行指定的包。

此时生成app.dill的进程，我们暂且称为“编译进程”，后续热重载增量的dill，也是驱动该进程生成。

attach设备

在上述的第二步，设备在启动运行App时，会打开App中DartVM的Observatory服务，本质是一个websocket服务，按照自定义的jsonrpc2.0协议进行通信，在attach时，会通过URI连接上设备服务，如下图：

连上DartVM服务后，会注册几个热重载事件：reloadSources，reloadMethod，hotRestart，这几个事件并不是注册到App中的Dart虚拟机，而是提供给flutter tool其他命令使用，如下图：

同时通过DartVM服务，来初始设备中flutter产物，设备中产物路径是临时生成，用XXX代替，产物路径为：

• Android中为：file:///data/user/0/com.example.flutter_app/code_cache/XXX/flutter_app/
• iOS模拟器中为：/Users/hexianting/资源库/Developer/CoreSimulator/Devices/BC003085-8F19-4EF3-AB84-BD44282F79B7(模拟器设备ID)/data/Containers/Data/Application/745DE582-59F1-4193-9692-131E611A9359/tmp/XXX/flutter_app/

具体代码如下：

3.3.3 触发热重载

下面分别从源码角度，看看到底做了什么?

开发者在执行flutter run或者flutter attach后，在终端中输入r，即可体验到重载效果，如果在Android Studio和VSCode中，直接Ctrl+S或者Cmd+S即可。

对应到源码入口：

不管是HotReload还是HotRestart，最终都是调用HotRunner.restart方法，一路跟进，最终会到某个具体设备update方法，并再次调用上述《热重载流程-首次启动》中的_compile方法，通知编译进程生成增量的dill文件app.dill.incremental.dill。那这个增量文件到底是什么呢?demo中修改字符串"Flutter Demo Home Page"为"Flutter Demo Home Page2"，来看看dill文件内容：

第一张图为修改前，第二种为修改后，第三张为增量的dill内容。可以看出增量的dill文件仅包含改动的dart文件代码。

生成增量的dill后，会通过_DevFSHttpWriter写入设备，如下图：

当同步完增量文件，最后还需要通知DartVM去刷新UI界面，这个步骤就跟我们上述的2.4节内容类似：

vmService.reloadSources最终调用了_call方法，这是一个dart官方库，如下：

HotRestart与HotReload区别

Flutter官方提供两种快速调试方法，一种是HotReload，另一种是HotRestart。前者无感知局部刷新，体验最好，但是缺点也很明显，适用比较局限，可以参考官网给出样例：HotReload，主要有这几种场景不适用：

• enum改成class类;
• 字体修改;
• 泛类型修改;
• Android和iOS原生修改;

而在HotRestart流程中，相比HotReload流程，增加了清除资源操作，同时不再生成增量的dill文件，每次改动都是生成全量的app.dill文件，该细节就不展开，感兴趣读者可以debug源码看。

上述可以看出HotRestart额外处理了一些事情，包括杀掉非UI的isolate，重置UI的isolate等。

对于dill文件同步到设备中位置，不同设备不一样：

• Android：file:///data/user/0/com.example.flutter_app/code_cache/XXX/flutter_app/lib/
• iOS模拟器：/Users/hexianting/Library/Developer/CoreSimulator/Devices/BC003085-8F19-4EF3-AB84-BD44282F79B7(模拟器设备ID)/data/Containers/Data/Application/9C8E4694-AC99-4A5C-BC46-63567F1C6FD9/tmp/XXX/flutter_app/lib/

至此，热重载源码就告一段落，很多奇技淫巧并不能一一展现，值得大家动手去看看。

四、总结

经过上述一顿探索，文章最早提出的几个疑问，想必都有了答案。这里只是介绍了Flutter源码的冰山一角，更多源码还需要继续探索，通过阅读源码，可做的事情很多：

• 通过文件监听+vm_service通信，干掉手动输入r或者R的这种无(gou)语(shi)设计;
• 源码中并没有限制多个设备，flutter run同时运行在多个模拟器中，并开启热重载;
• iOS模拟器不重新安装App的情况下，直接替换模拟器中的flutter产物，以达到快速调试手段;
• debug状态下的DartVM可以通过热重载来动态化，但性能较低，与谷歌Flutter的高性能目标不符;

总之，可做的事情很多，那我们看源码的意义就非常清晰：

• 深入了解Flutter运行机制，去定制Flutter框架;
• 通过研究这些顶级工程师的实现思路，去完善我们自己的逻辑体系，从而成为一个更加严谨的人。

五、参考资料

• https://flutter.dev/docs/development/tools/hot-reload
• http://gityuan.com/2019/09/07/flutter_run/
• https://github.com/dart-lang/sdk/blob/master/runtime/vm/service/service.md
• http://static.kancloud.cn/alex_wsc/flutter_demo/1570089