Skip to content

12. 部署

开发期间,应用在[flutter run]的控制下运行:处于“调试”模式,速度较慢,支持热重载,并带有由[assert]执行的检查([Flutter])。要部署它,我们以“发布”模式构建它:优化后的代码,不带开发工具。每个平台构建一个版本。

12.1. Web 版本

  1. 构建客户端。在[rdvmedecins_flutter]文件夹中:
flutter build web --no-web-resources-cdn

控制台显示:

1
2
3
4
5
6
7
Compiling lib\main.dart for the Web...
Wasm dry run succeeded. Consider building and testing your application with the `--wasm` flag. See docs for more info: https://docs.flutter.dev/platform-integration/web/wasm
Use --no-wasm-dry-run to disable these warnings.
Expected to find fonts for (MaterialIcons, packages/cupertino_icons/CupertinoIcons), but found (MaterialIcons). This usually means you are referring to font families in an IconData class but not including them in the assets section of your pubspec.yaml, are missing the package that would include them, or are missing "uses-material-design: true".
Font asset "MaterialIcons-Regular.otf" was tree-shaken, reducing it from 1645184 to 9004 bytes (99.5% reduction). Tree-shaking can be disabled by providing the --no-tree-shake-icons flag when building your app.
Compiling lib\main.dart for the Web...                             70,5s
√ Built build\web

两条警告,没有任何影响:可以编译为[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]版本。

  1. 将其放到服务器上。把 [build/web/] 文件夹的内容复制到 JSON 服务器根目录下名为[client/] 的文件夹中([rdvmedecins-nestjs-json/client/index.html]、[rdvmedecins-nestjs-json/client/main.dart.js]……),然后重启服务器。它会显示:
[Nest] LOG [RdvMedecins] web client served from .../rdvmedecins-nestjs-json/client
[Nest] LOG [RdvMedecins] JSON server started: http://localhost:8080/api

完整的应用现在可通过 http://localhost:8080 访问。服务器提供客户端的文件,并对 /api 之外的任何其他地址返回[index.html] :重新加载 /schedule 页面可以正常工作(是客户端的路由器显示它)。服务器的[src/web/client-spa.ts]文件负责这项任务。应用由 API 服务器提供:[config.dart] 的相对地址([''],或[/api/...])是正确的。

你也可以用任何文件服务器来试用不带 JSON 服务器的构建版本,但 /api 请求会失败。

12.2. Android 版本

  1. 构建应用,并指定服务器地址:
flutter build apk --dart-define=SERVER=http://192.168.1.20:8080

控制台显示(针对不带[--dart-define]构建的 APK):

1
2
3
4
Running Gradle task 'assembleRelease'...
Font asset "MaterialIcons-Regular.otf" was tree-shaken, reducing it from 1645184 to 3400 bytes (99.8% reduction). Tree-shaking can be disabled by providing the --no-tree-shake-icons flag when building your app.
Running Gradle task 'assembleRelease'...                          193,4s
√ Built build\app\outputs\flutter-apk\app-release.apk (53.5MB)

(已删除一些关于[Gradle] 和[Java]的警告,它们没有任何影响。)第一次构建需要很长时间:[Gradle] 要下载它自己的工具和库;之后的构建会快得多。

[Dart]编译器将应用翻译成了适用于[Android]手机三个处理器系列(ARM 32 位、ARM 64 位、x86 64 位)的机器码,而[Android]构建工具([Gradle])将其与[Flutter]引擎一起打包成一个APK文件:即[Android]应用的安装格式。它包含应用及其引擎的三份副本——每个处理器系列一份——这就解释了它的大小。[--split-per-abi] 会生成三个较小的 APK 文件,每个处理器系列一个;“App Bundle”(见下文)则允许应用商店只分发每部手机所需的内容。

  1. 安装它。手机与计算机连接(USB 数据线,已启用 USB 调试)后:
flutter install

你也可以把 APK 文件复制到手机上并打开它:[Android] 随后会要求你允许安装“来自未知来源”的应用。

  1. 正式发布时:
  • 应用必须使用开发者专属的密钥进行签名 :由[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]。