找到下面的代码:

  1. home: MyHomePage(title: 'Flutter Demo Home Page'),

将这行代码改为:

  1. home: MyHomePage(title: 'Hello World'),

使用快捷键 ctrl+s(Windows、Linux)或者 cmd+s(MacOS),这个快捷键其实是保存代码,但是可以触发 Hot Reload。或者点击 Hot Reload 的按钮:

Android Studio 的 Hot Reload 按钮:

image.png

VS Code 的 Hot Reload 按钮:

image.png

就可以看到运行的 Flutter APP 的 TitleBar 的内容发生了变化:

image.png

是不是很神奇,不需要重新编译,就能实时看到代码的变更,这个功能就是 Flutter 的 Hot Reload。
Flutter 的 Hot Reload 功能可以帮助开发者方便快速的调试代码,构建 UI,添加功能和修复 bug。

Hot Reload 的工作原理

Hot Reload 只能在 Debug 模式下使用,是因为 Debug 模式下,Flutter 采用的是 JIT 动态编译,代码是运行在 Dart VM 上,JIT 将 Dart 编译成可以运行在 Dart VM 上的 Dart Kernel,Dart Kernel 可以动态更新,所以就实现了代码的实时更新功能。
当调用 Hot Reload 时:

  1. 首先会扫描代码,找到上次编译之后有变化的 Dart 代码。
  2. 在将这些变化的 Dart 代码转化为增量的 Dart Kernel 文件。
  3. 将增量的 Dart Kernel 文件发送到正在移动设备上运行的 Dart VM。
  4. Dart VM 会将发来的增量 Dart Kernel 文件和原有的 Dart Kernel 文件合并,然后重新加载全新的 Dart Kernel。
  5. 这个时候,虽然重新加载了 Dart Kernel,却不会重新执行代码,而是通知 Flutter Framework 重建 Widget。

所以 Flutter 的 Hot Reload 并不会重新执行一遍代码,而是触发 Flutter 重新绘制,并且会保留 Flutter 之前的状态,所以 Hot Reload 也被称为有状态的热重载。

不能使用 Hot Reload 的场景

代码出现编译错误的不能使用 Hot Reload

当代码更改引入编译错误时,肯定不能使用 Hot Reload。
所以要先解决编译错误,在使用 Hot Reload。

代码更改会影响 APP 状态的不能使用 Hot Reload

如果你的代码更改会影响 APP 的状态,使得代码更改之后的状态和代码更改之前的状态不一样,那么 Hot Reload 就不会生效,例如:

  1. class MyWidget extends StatelessWidget {
  2. Widget build(BuildContext context) {
  3. return GestureDetector(onTap: () => print('T'));
  4. }
  5. }

这段代码,运行 App 之后,将 StatelessWidget 改为 StatefulWidget

  1. class MyWidget extends StatefulWidget {
  2. @override
  3. State<MyWidget> createState() => MyWidgetState();
  4. }
  5. class MyWidgetState extends State<MyWidget> { /*...*/ }

因为 Hot Reload 会保留状态,在代码更改之前,MyWidgetStatelessWidget,将 StatelessWidget 改为 StatefulWidget ,如果 Hot Reload 成功,那么 MyWidget 会变成 StatefulWidget ,与它之前的状态就会不兼容的,所以 Hot Reload 是不会成功的。

全局变量( global variables)和静态字段(static fields)的更改不能使用 Hot Reload

在 Flutter 中,全局变量和静态字段被视为状态,因此在 Hot Reload 期间不会重新初始化。
如下的代码:

  1. final sampleTable = [
  2. Table("T1"),
  3. Table("T2"),
  4. Table("T3"),
  5. Table("T4"),
  6. ];

运行 App 之后,如果做了如下的更改:

  1. final sampleTable = [
  2. Table("T1"),
  3. Table("T2"),
  4. Table("T3"),
  5. Table("T10"), // 修改这里的值
  6. ];

运行 Hot Reload,是不会成功的,所以全局变量和静态字段不能使用 Hot Reload。

main() 方法里的更改不能使用 Hot Reload

因为 main() 方法不会因重建窗口小部件树而重新执行,所以更改 main() 方法里的代码,不会在 Hot Reload 之后看到效果。

例如,如下的代码:

  1. import 'package:flutter/material.dart';
  2. void main() {
  3. runApp(MyApp());
  4. }
  5. class MyApp extends StatelessWidget {
  6. Widget build(BuildContext context) {
  7. return GestureDetector(onTap: () => print('tapped'));
  8. }
  9. }

在运行 App 后,更改如下:

  1. import 'package:flutter/widgets.dart';
  2. void main() {
  3. runApp(const Center(
  4. child: const Text('Hello', textDirection: TextDirection.ltr)));
  5. }

Hot Reload 之后,不会看到任何变化。

枚举类型更改为常规的类或者常规的类变为枚举类型也不能使用 HotReload

例如,如下的例子:

  1. enum Color {
  2. red,
  3. green,
  4. blue
  5. }

改为:

  1. class Color {
  2. Color(this.i, this.j);
  3. final int i;
  4. final int j;
  5. }

修改通用类型声明也不能使用 HotReload

例如,如下的例子:

  1. class A<T> {
  2. T i;
  3. }

改为:

  1. class A<T, V> {
  2. T i;
  3. V v;
  4. }

Hot Reload VS Hot Restart

针对上面不能使用 Hot Reload 的情况,就需要使用 Hot Restart。
Hot Restart 可以完全重启您的应用程序,但却不用结束调试会话。

Android Studio 里执行 Hot Restart

在 Android Studio 里,无需 stop,在 run 一下,就是 Hot Restart。

VS Code 里执行 Hot Restart

在 VS Code 里,打开命令面板,输入 Flutter: Hot Restart 或者 直接快捷键 Ctrl+F5,就可以使用 Hot Restart。

参考

【1】Flutter 实战
【2】Flutter 中文文档
【3】Flutter 完全手册