12. 部署
开发期间,应用在[flutter run]的控制下运行:处于“调试”模式,速度较慢,支持热重载,并带有由[assert]执行的检查([Flutter])。要部署它,我们以“发布”模式构建它:优化后的代码,不带开发工具。每个平台构建一个版本。
12.1. Web 版本
- 构建客户端。在[rdvmedecins_flutter]文件夹中:
控制台显示:
两条警告,没有任何影响:可以编译为[WebAssembly] (见下文);[Flutter] 中的一个库引用了[iOS] 风格([CupertinoIcons])的图标,而应用并不使用它。
[dart2js]编译器已将整个应用([Dart]、[Flutter]和各个包)编译为[JavaScript],输出到[build/web/]文件夹中:
- [index.html]:应用页面本身,它加载[flutter_bootstrap.js],然后加载[main.dart.js] (3.5 MB,经服务器压缩后约 1 MB):这是我们自己的代码,连同[Flutter] 和各个包的全部代码,经过了优化。[Flutter] 不生成 HTML:应用使用与手机上相同的引擎,在画布上自行绘制每一个像素;
- [canvaskit/]:这个渲染引擎([Skia],编译为[WebAssembly]:[canvaskit.wasm],7 MB)。如果没有[--no-web-resources-cdn]选项,它会从[Google]服务器下载;有了该选项,它就随应用一起打包,应用不再依赖任何外部站点;
- [assets/]:来自[pubspec.yaml] 的资源(字典、字体)。图标经过了“摇树优化”:图标字体中只保留应用用到的图标;
- 首次加载时,浏览器会下载几兆字节(主要是渲染引擎),然后将其缓存。这是[Flutter] 用于 Web 的主要弱点:它更适合应用(会被打开并长时间使用),而不是网站(只是短暂浏览)。
[--wasm]选项将应用编译为[WebAssembly] 而不是[JavaScript]:在支持它的浏览器(较新版本的[Chrome]、[Edge]和[Firefox])中速度更快;其他浏览器会自动获得[JavaScript]版本。
- 将其放到服务器上。把 [build/web/] 文件夹的内容复制到 JSON 服务器根目录下名为[client/] 的文件夹中([rdvmedecins-nestjs-json/client/index.html]、[rdvmedecins-nestjs-json/client/main.dart.js]……),然后重启服务器。它会显示:
完整的应用现在可通过 http://localhost:8080 访问。服务器提供客户端的文件,并对 /api 之外的任何其他地址返回[index.html] :重新加载 /schedule 页面可以正常工作(是客户端的路由器显示它)。服务器的[src/web/client-spa.ts]文件负责这项任务。应用由 API 服务器提供:[config.dart] 的相对地址([''],或[/api/...])是正确的。
你也可以用任何文件服务器来试用不带 JSON 服务器的构建版本,但 /api 请求会失败。
12.2. Android 版本
- 构建应用,并指定服务器地址:
控制台显示(针对不带[--dart-define]构建的 APK):
(已删除一些关于[Gradle] 和[Java]的警告,它们没有任何影响。)第一次构建需要很长时间:[Gradle] 要下载它自己的工具和库;之后的构建会快得多。
[Dart]编译器将应用翻译成了适用于[Android]手机三个处理器系列(ARM 32 位、ARM 64 位、x86 64 位)的机器码,而[Android]构建工具([Gradle])将其与[Flutter]引擎一起打包成一个APK文件:即[Android]应用的安装格式。它包含应用及其引擎的三份副本——每个处理器系列一份——这就解释了它的大小。[--split-per-abi] 会生成三个较小的 APK 文件,每个处理器系列一个;“App Bundle”(见下文)则允许应用商店只分发每部手机所需的内容。
- 安装它。手机与计算机连接(USB 数据线,已启用 USB 调试)后:
你也可以把 APK 文件复制到手机上并打开它:[Android] 随后会要求你允许安装“来自未知来源”的应用。
- 正式发布时:
- 应用必须使用开发者专属的密钥进行签名 :由[flutter create] 生成的项目会用调试密钥为“release”版本签名,这对测试足够了,但不适用于应用商店。[Flutter]文档(“Build and release an Android app”)介绍了如何创建密钥并配置[Gradle];
- [Google Play Store] 需要的是“Android App Bundle”而不是 APK:[flutter build appbundle];
- 应用名称和图标在[android/app/src/main/AndroidManifest.xml] ([android:label])和[android/app/src/main/res/mipmap-*/]中配置;
- 服务器必须设置为 HTTPS(会传输密码),并且要从清单文件中删除[android:usesCleartextTraffic="true"] 这一行。
12.3. 生产服务器
在真正的生产环境中,别忘了服务器上的[.env]文件:
- 一个长而随机的[JWT_SECRET];
- 一个空的[CAPTCHA_TEST];
- [COOKIE_SECURE=true] 如果站点通过 HTTPS 提供(必须如此)。移动客户端无论该选项如何都会发送 Cookie:该选项是由浏览器强制执行的;
- [TRUST_PROXY=true] 如果服务器位于代理([nginx]……)之后,这样尝试次数限制才能看到客户端的真实 IP 地址。
然后我们启动编译后的服务器:[npm run build],接着是[npm run start:prod]。