4. 第 3 章 - Flutter 入门
4.1. 资料来源
官方文档:https://docs.flutter.dev——尤其是“What is Flutter?”、“Introduction to widgets”和“State management”这几页。[Dart]语言:https://dart.dev/language
4.2. Flutter 不是什么
这是本章最重要的出发点,因为它与本课程之前的三个版本有很大不同。[Angular]、[React]、和 [Vue.js] 生成的都是编译后的 [JavaScript]/[TypeScript] ,由浏览器中已有的 [JavaScript]引擎执行——该引擎通过 [DOM] 和 [CSS]负责所有的显示工作。像 [Cordova]/[Capacitor] 这样的工具(本课程不使用)确实可以将这样的 Web 客户端打包进移动外壳,但客户端仍然运行在嵌入式浏览器([WebView])中——绝不是原生运行。
[Flutter] 与这一切毫无关系。本文档中的 [Dart]代码,无论是移动端还是桌面端,都会被编译为原生机器码([AOT]编译,[Ahead-Of-Time]——与 C++ 或 Rust 程序属于同一类编译方式),可由目标操作系统直接执行;它不需要任何 [JavaScript] 解释器或 [WebView]。[Flutter] 自带图形渲染引擎([Impeller],它在移动设备上取代 [Skia] 成为默认引擎):应用逐帧自行绘制每一个像素,而不是把显示委托给操作系统的原生组件(Widget)(这与 [React Native]不同,后者本课程不使用,它转而驱动 [Android]/[iOS]的真实界面组件)。正是这一架构选择,使 [Flutter] 能够在本文档所针对的三种环境中呈现完全一致的界面——不存在外观可能因平台而异的原生操作系统组件。
不过,在[web] 目标上,显然不存在编译为本机机器码的过程:[flutter build web] 会把[Dart] 代码编译为 [JavaScript] (或编译为 [WebAssembly],一个较新的目标),由浏览器执行——但这段生成的 [JavaScript] 并不会操作 [DOM] 或 [HTML] ,这一点不同于 [Vue.js] 的做法:它同样直接渲染到单个 [<canvas>] 元素上(或者根据所选的渲染模式,通过自动生成的 [HTML] 元素渲染),从而在移动端、桌面端和 Web 端复现相同的 [Flutter] 外观 ,而不是依赖用 [HTML] 元素并以 [CSS] 设置样式的方式。
4.3. Flutter 开发模型:一切皆组件(Widget)
[Angular]、[React] 和 [Vue.js]——这三者都把组件的逻辑(LOGIC,用 [TypeScript] 编写)与其展示(PRESENTATION,即 [HTML] 模板,根据框架的不同,可以是独立的,也可以是集成的——参见本课程 [Vue.js] 文档的第 4 章“组件:[.vue] 文件与 [Composition API]”)区分开来。[Flutter] 则彻底取消了这种区分:在 [Flutter] 界面中,一切(EVERYTHING)都是 [Widget]——按钮、文本、边距、对齐方式和背景色都是组件(Widget),一个完整的界面不过是一棵由相互嵌套的组件构成的树(TREE),由普通的 [Dart] 代码(即 [build(BuildContext context)] 方法)来描述,而不是由单独的模板语言来描述——在这一点上,[Flutter] 把 [React] ([JSX],由 [JavaScript] 来描述界面)已经做出的选择推进得更远:[JSX] 仍然是一种标记语言——与 [JavaScript] 混合使用——而 [build(...)] 只是返回一个 [Dart] 表达式(EXPRESSION)——即嵌套的构造函数调用([Scaffold(appBar: ..., body: Column(children: [...]))]),无需学习任何额外的语法。
4.4. StatelessWidget 与 StatefulWidget:而 Vue.js 无需这种区分
[Vue.js] (以及本课程中先前的 [React] 和 [Angular])在结构上并不区分拥有可变状态的组件与没有可变状态的组件:[ref(...)] 可以在任意 [<script setup>] 中调用,也可以不调用,而无需改变组件本身的声明。[Flutter] 强制要求这种区分,从类的声明处就开始:[StatelessWidget] (构造之后不会再发生任何变化——参见第 4 章中的 [ScheduleView] 和 [LoginPage] )仅在其参数变化时才重新执行 [build(...)] 方法;[StatefulWidget] 则与一个单独的 [State<T>] 类配对(参见第 4 章中的 [_LoginFormState]、[_AppRootState]……),由它持有可变状态以及 [setState(() { ... })] 方法——这是触发重新渲染的显式(EXPLICIT)调用,而 [reactive(...)] 在 [Vue.js] 一侧会自动检测每一次属性写入。把组件拆分为两个类(Widget/State)是 [Flutter] 刻意设计的直接结果:[Widget] 对象是不可变的(IMMUTABLE,每次渲染都会重新构建,就像一个简单的配置对象),而与之关联的 [State] 则在两次渲染之间得以保留(SURVIVES)。
4.5. 在组件之间共享状态:provider,相当于 provide/inject
[Vue.js] 通过 [provide]/[inject] 这一对函数在相距较远的组件之间共享状态;[React] 使用 [Context];[Angular] 使用可注入的单例服务。[Flutter] 框架本身并没有内置这些机制,这一作用由第三方包 [provider] (参见第 4 章的 [pubspec.yaml])承担,它在 [Flutter] 生态中几乎不可或缺。其原理是:一个 [ChangeNotifier] 类(一个标准的 [Dart] 类,可以通过 [notifyListeners()] 把变化通知给其监听者),由放置在子树根部的 [ChangeNotifierProvider] 提供给整个组件子树(参见 [MultiProvider] 在 [lib/main.dart] 中的用法,它相当于 [app.provide(key, value)] 在 [Vue.js] 一侧的调用);随后任何后代组件都可以通过 [context.watch<MyService>()] (订阅后续的变化——相当于 [useXxx()] 在 [Vue.js] 一侧的作用)或 [context.read<MyService>()](一次性读取,不重新订阅——这是 [Vue.js] 无需做出的区分)重新读取它。
与 [reactive(...)] 的关键区别:[ChangeNotifier] 不会自动检测任何(ANYTHING)变化。[reactive(...)] 会把对象包装在一个 [JavaScript] 代理中,由它拦截每一次属性读取和每一次属性写入;而 [ChangeNotifier] [Dart] 只是一个普通的类,开发者必须在每次应当触发重新渲染的修改之后,显式调用 [notifyListeners()] ——这需要更多手动的自律,换来的是一种无需依赖“魔法”代理就能理解的机制。
4.6. 没有单独的模板语言:条件渲染与列表
[v-if]/[v-else] 和 [v-for] ([Vue.js]一侧),以及 [@if]/[@for] ([Angular]一侧),或者三元运算符 && 和 [.map(...)] ([React] 一侧)——在 [Flutter] 中都被还原为 普通的 [Dart] 表达式,直接写在 [build(...)] 之中:条件使用经典的 [Dart] [if]/[else],列表则使用 [.map((element) => Widget(...)).toList()] ——其概念与 [.map(...)] 在 [React] 一侧的用法相同,因为 [Flutter] 和 [React] 一样,不存在有别于编程语言本身的单独“模板语言”。[if (condition) ...[ WidgetA, WidgetB ]] 语法(“if collection”,例如用于 [lib/app.dart],第 4 章)把这一逻辑比 [React] 又推进了一步:直接在组件的字面量列表中插入一个条件(CONDITION),无需三元运算符或中间函数。
4.7. Dart:与 TypeScript 关系密切,而非 JavaScript
[Dart] 从来就不是为 Web 而设计的 [TypeScript] 的替代品(后者是专门作为 [JavaScript] 的超集而设计的):它是一门独立的语言,从一开始就是静态类型的(没有隐式的“[any]”模式),是编译型的——绝不会原样解释执行。对于来自 [TypeScript] (就像本课程中先前的三个变体)的开发者来说,核心内容几乎可以直接对应:类、接口([Dart] 使用 [abstract class] 或简单的被实现的类,而不是单独的 [interface] 关键字)、泛型([ServerResponse<T>],参见第 4 章)、基于 [async]/[await] 的 [Future<T>](与 [TypeScript] 中的 [Promise<T>] 完全等价(EXACT)),以及内置于类型系统中的可空性检查([String?] ,而不是总是存在的字符串——相当于 [strict] 模式在 [TypeScript] 中的作用,但由语言本身强制执行,而不是通过编译器选项)。
一个值得注意的区别,在下一章每个解码 JSON 的文件中都会遇到([core/models/appointment_models.dart]):[TypeScript] 在编译时就会擦除其类型——[interface] 只在编译时检查,解码得到的 JSON 对象在运行时会被原样使用([JSON.parse(...) as ServerResponse<T>],只是对编译器做出的一个简单承诺)。[Dart]则相反,其类型在运行时确定:[jsonDecode(...)] 总是返回动态类型([Map<String, dynamic>]),必须使用手写的 [fromJson(...)] 构造函数显式地转换为类的实例——起初更为冗长,但缺失的键或类型不符的值随后会立即抛出清晰的异常,而不是悄无声息地继续传播。
4.8. 第一个最小示例
下面是在屏幕上显示内容的最小 [Flutter] 应用——不妨将它与第 4 章中的 [lib/main.dart]/[lib/app.dart] 对比,后者的功能丰富得多,但构建时使用的却是完全相同(EXACTLY)的基本构件([runApp(...)]、[MaterialApp] 和一个根组件)。
我们来逐段讲解这段代码:
- 第 1 行:[import 'package:flutter/material.dart';] ——相当于 [import { ... } from 'vue']:[material.dart] 包含本文档中使用的所有“Material Design”组件([Google])——按钮、文本字段、应用栏等。[Flutter] 还提供了一组 [Cupertino] 组件(采用 [iOS] 风格),本课程不使用它们,供在移动设备([Apple])上偏好这种风格的人使用。
- 第 3 行:[void main() {] ——[Dart] 程序的入口点,与 [C]/[Java] 程序的入口点完全一样(EXACTLY)——[Flutter] 没有与网页的 [HTML] 相对应的东西,也就没有需要把 [main.ts] 脚本嵌入其中的页面:应用就直接从这里启动。
- 第 4 行:[runApp(...)] ——启动 [Flutter] 渲染引擎,并向其提供要显示的根组件——相当于 [createApp(App).mount('#app')] 在 [Vue.js] 一侧([src/main.ts])的作用,只需一次调用,而不是两次。
- 第 5–9 行:[MaterialApp(home: Scaffold(body: Center(...)))] ——一棵由嵌套组件构成的树,每个组件各有明确的职责:[MaterialApp] 配置主题和导航;[Scaffold] 提供标准的屏幕结构(应用栏区域、内容区域等);[Center] 使其子组件居中;[Text] 显示一个字符串。这四个组件都不是语言的特例:它们只是 [Dart] 类,和本课程在下一章中自己编写的那些类一样。
4.9. 小结:Angular -> React -> Vue.js -> Flutter
完整版本另请参见 [README.md] ,它随本章的代码一同提供。
- [Angular] 组件 / [.vue] 文件 / [.tsx] 文件 → [Widgets] [Dart]([StatelessWidget]/[StatefulWidget])
- [signal()]/[ref()]/[useState()] → 可变字段 + [setState(...)] (局部状态),[ChangeNotifier] (共享状态)
- [input()]/[output()]、[defineProps]/[defineEmits]、函数属性 → 构造函数参数(输入)、作为参数传递的函数(输出)
- 可注入的/组合式服务 + [provide]/[inject]/[Context] → 服务类 + 包 [provider]
- 单独的模板 [Angular]、[<template>]、[Vue.js]、[JSX], [React] → 方法 [build(BuildContext)] (纯 Dart)
- [HttpClient]/[fetch] → 包 [http]
- [localStorage] → [shared_preferences]
- 没有路由器(本课程全部 5 个变体都是单屏应用)