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
- Erstellen Sie den Client. Im Ordner [rdvmedecins_flutter]:
Die Konsole zeigt Folgendes an:
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.
- 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:
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
- Erstellen Sie die App und geben Sie dabei die Serveradresse an:
Die Konsole zeigt Folgendes an (für eine APK, die ohne [--dart-define] erstellt wurde):
(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.
- Installieren Sie sie. Bei einem per USB-Kabel mit dem Computer verbundenen Smartphone (USB-Debugging aktiviert):
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.
- 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].