Skip to content

12. Bereitstellung

Während der Entwicklung läuft die Anwendung unter der Kontrolle von [flutter run]: im „Debug“-Modus, der langsamer ist, mit Hot Reload und Prüfungen ([assert]), die von [Flutter] durchgeführt werden. Für die Bereitstellung erstellen wir sie als Build im „Release“-Modus: optimierter Code, ohne Entwicklungswerkzeuge. Wir erstellen eine Version pro Plattform.

12.1. Die Webversion

  1. Erstellen Sie den Client. Im Ordner [rdvmedecins_flutter]:
flutter build web --no-web-resources-cdn

Die Konsole zeigt Folgendes an:

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

Zwei Warnungen ohne Folgen: Die Kompilierung nach [WebAssembly] wäre möglich (siehe unten); eine Bibliothek von [Flutter] verweist auf Symbole des [iOS] -Stils ([CupertinoIcons]), den die Anwendung nicht verwendet.

Der [dart2js]-Compiler hat die gesamte Anwendung ([Dart], [Flutter] und die Pakete) in [JavaScript] kompiliert, im Ordner [build/web/]:

  • [index.html]: DIE Anwendungsseite, die [flutter_bootstrap.js] lädt, dann [main.dart.js] (3,5 MB, etwa 1 MB nach der Komprimierung durch den Server): UNSER Code, zusammen mit dem gesamten Code von [Flutter] und den Paketen, optimiert. [Flutter] erzeugt kein HTML: Die Anwendung zeichnet jedes Pixel selbst auf eine Canvas-Fläche, mit derselben Engine wie auf dem Smartphone;
  • [canvaskit/]: diese Rendering-Engine ([Skia], kompiliert nach [WebAssembly]: [canvaskit.wasm], 7 MB). Ohne die Option [--no-web-resources-cdn] würde sie von einem [Google]-Server heruntergeladen; mit ihr ist sie in der Anwendung enthalten, die dann von keiner externen Website mehr abhängt;
  • [assets/]: die Ressourcen aus [pubspec.yaml] (Wörterbücher, Schriftarten). Die Symbole werden per „Tree Shaking“ reduziert: Nur die von der Anwendung verwendeten bleiben in der Symbolschrift erhalten;
  • Beim ersten Laden lädt der Browser einige Megabyte herunter (hauptsächlich die Rendering-Engine) und legt sie dann im Cache ab. Dies ist die Hauptschwäche von [Flutter] im Web: Es eignet sich besser für Anwendungen (die geöffnet und lange genutzt werden) als für Websites (die nur kurz durchstöbert werden).

Die Option [--wasm] kompiliert die Anwendung als [WebAssembly] statt als [JavaScript]: Sie ist in Browsern schneller, die dies unterstützen (aktuelle Versionen von [Chrome], [Edge] und [Firefox]); andere Browser erhalten automatisch die [JavaScript]-Version.

  1. Auf dem Server ablegen. Kopieren Sie den INHALT des Ordners [build/web/] in einen Ordner namens [client/] im Stammverzeichnis des JSON-Servers ([rdvmedecins-nestjs-json/client/index.html], [rdvmedecins-nestjs-json/client/main.dart.js] ...) und starten Sie den Server neu. Er zeigt Folgendes an:
[Nest] LOG [RdvMedecins] web client served from .../rdvmedecins-nestjs-json/client
[Nest] LOG [RdvMedecins] JSON server started: http://localhost:8080/api

Die vollständige Anwendung ist nun unter http://localhost:8080 verfügbar. Der Server liefert die Dateien des Clients aus und gibt [index.html] für jede andere Adresse außerhalb von /api zurück: Das Neuladen der Seite /schedule funktioniert (der Router des Clients zeigt sie an). Die Datei [src/web/client-spa.ts] des Servers übernimmt diese Aufgabe. Die Anwendung wird vom API-Server ausgeliefert: Die relative Adresse aus [config.dart] ([''] oder [/api/...]) ist korrekt.

Sie können auch die Version ausprobieren, die ohne den JSON-Server erstellt wurde, mit einem beliebigen Dateiserver, aber die Anfragen an /api schlagen fehl.

12.2. Die Android-Version

  1. Erstellen Sie die App und geben Sie dabei die Serveradresse an:
flutter build apk --dart-define=SERVER=http://192.168.1.20:8080

Die Konsole zeigt Folgendes an (für eine APK, die ohne [--dart-define] erstellt wurde):

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)

(Einige Warnungen zu [Gradle] und [Java], die ohne Auswirkung blieben, wurden entfernt.) Der erste Build dauert lange: [Gradle] lädt seine eigenen Werkzeuge und Bibliotheken herunter; spätere Builds sind deutlich schneller.

Der [Dart]-Compiler hat die Anwendung in Maschinencode für die drei Prozessorfamilien der [Android]-Smartphones übersetzt (ARM 32 Bit, ARM 64 Bit, x86 64 Bit), und das Build-Werkzeug von [Android] ([Gradle]) hat sie zusammen mit der [Flutter]-Engine in eine APK-Datei verpackt: das Installationsformat für [Android]-Anwendungen. Sie enthält drei Kopien der Anwendung und ihrer Engine – eine pro Prozessorfamilie –, was ihre Größe erklärt. [--split-per-abi] würde drei kleinere APK-Dateien erzeugen, eine pro Prozessorfamilie; ein „App Bundle“ (siehe unten) ermöglicht es dem Store, jedem Smartphone nur das zu liefern, was es benötigt.

  1. Installieren Sie sie. Bei einem per USB-Kabel mit dem Computer verbundenen Smartphone (USB-Debugging aktiviert):
flutter install

Sie können die APK-Datei auch auf das Smartphone kopieren und öffnen: [Android] fordert Sie dann auf, die Installation von Apps aus „unbekannten Quellen“ zuzulassen.

  1. Für eine echte Veröffentlichung:
  • Die App muss mit einem entwicklerspezifischen Schlüssel signiert werden: Das von [flutter create] erzeugte Projekt signiert die „Release“-Version mit dem Debug-Schlüssel, was für Tests ausreicht, aber nicht für einen Store. Die Dokumentation von [Flutter] („Build and release an Android app“) beschreibt, wie Sie den Schlüssel erstellen und [Gradle] konfigurieren;
  • [Google Play Store] erwartet ein „Android App Bundle“ statt einer APK: [flutter build appbundle];
  • Der Name und das Symbol der App werden in [android/app/src/main/AndroidManifest.xml] ([android:label]) und [android/app/src/main/res/mipmap-*/] konfiguriert;
  • Der Server muss auf HTTPS umgestellt werden (es werden Passwörter übertragen), und die Zeile [android:usesCleartextTraffic="true"] wird aus dem Manifest entfernt.

12.3. Der Produktionsserver

Vergessen Sie im echten Produktionsbetrieb nicht die Datei [.env] auf dem Server:

  • ein langes, zufälliges [JWT_SECRET];
  • ein leeres [CAPTCHA_TEST];
  • [COOKIE_SECURE=true] , wenn die Website über HTTPS ausgeliefert wird (was der Fall sein muss). Der mobile Client sendet das Cookie unabhängig von dieser Option: Sie wird vom Browser durchgesetzt;
  • [TRUST_PROXY=true] , wenn sich der Server hinter einem Proxy befindet ([nginx] ...), damit die Begrenzung der Versuche die tatsächliche IP-Adresse der Clients sieht.

Anschließend starten wir den kompilierten Server: [npm run build], gefolgt von [npm run start:prod].