7. Internationalisierung
7.1. Beispiel 21: Eine zweisprachige Anwendung
Eine zweisprachige Anwendung hat drei Arten von zu übersetzendem Text:
- Anwendungstext: Beschriftungen und Meldungen. Sie werden in Wörterbüchern gespeichert, eines pro Sprache;
- Datumsangaben und Beträge: das Paket [intl] (siehe Beispiel 09) in der aktuellen Sprache;
- Text des Pakets [Flutter] selbst: die Schaltflächen seiner Fenster, die Tage und Monate seines Kalenders. Das Paket [flutter_localizations] stellt diese bereit.
7.1.1. Die Wörterbücher
Jeder Text hat einen Schlüssel ("HOME.HELLO"). Die Parameter werden als [{{name}}] geschrieben; ein Text im Plural hat mehrere Schlüssel, etwa [_zero], [_one] und [_other]. Das sind die Konventionen der [JavaScript] [i18next]-Bibliothek, die von den Clients [React] und [Vue.js] von [RdvMedecins] verwendet wird: Die Fallstudie wird deren Wörterbücher unverändert übernehmen. Das englische Wörterbuch hat dieselben Schlüssel:
7.1.2. Die Übersetzungen
- Zeilen 30–34: die Übersetzungen: ein [ChangeNotifier] (die Bildschirme werden neu aufgebaut, wenn sich die Sprache ändert), der die aktuelle Sprache und ihr Wörterbuch behält;
- Zeilen 42–45: die Ausgangssprache: die auf dem Gerät gespeicherte, andernfalls die Sprache des Smartphones (falls bekannt), andernfalls Englisch;
- Zeilen 48–54: die Sprache wechseln: das Wörterbuch laden, eine mit der Anwendung mitgelieferte JSON-Datei ([rootBundle.loadString] liest eine Datei aus dem Abschnitt [assets] von [pubspec.yaml]), es decodieren ([jsonDecode]), die Auswahl speichern und die Bildschirme aktualisieren;
- Zeilen 58–63: Suche nach dem Schlüssel „HOME.HELLO“ im Wörterbuch: Es durchläuft Abschnitt für Abschnitt die verschachtelten JSON-Objekte. [node is Map<String, Object?> ? ... : null]: eine Typprüfung, die die Variable in dem Zweig, in dem sie wahr ist, „befördert“ (Type Promotion);
- Zeilen 66–83: die Übersetzung. Bei einem Plural (ein ganzzahliger Parameter [count]) [Intl.pluralLogic] wählt die Form nach den Regeln der Sprache: Im Französischen sind 0 und 1 Singular, im Englischen nur 1. Ein unbekannter Schlüssel wird unverändert angezeigt: Sie sehen sofort, was fehlt. Schließlich wird jedes [{{name}}] durch den Wert des Parameters ersetzt.
Warum nicht das offizielle [Flutter]-Werkzeug verwenden? [Flutter] bietet einen Generator ([flutter gen-l10n]), der aus [.arb]-Dateien eine Klasse mit einer Methode pro Text erzeugt ([AppLocalizations.of(context).hello('Marie')]): Die Schlüssel werden zur Kompilierzeit geprüft. Das ist die beste Lösung für eine Anwendung, in der alle Texte im Voraus bekannt sind. Unser Server liefert jedoch Schlüssel („ERRORS.LOGIN_TAKEN“), die zur Laufzeit übersetzt werden müssen: Ein Wörterbuch, das über den Schlüssel abgefragt wird, eignet sich dafür weit besser und erlaubt es uns, die Wörterbücher mit anderen Clients zu teilen.
7.1.3. Die übersetzte Seite
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 | |
- Zeilen 30–31: eine Erweiterung von [BuildContext] (siehe Beispiel 09): [context.t('KEY')] liest die oben bereitgestellten Übersetzungen, abonniert Aktualisierungen und führt die Übersetzung aus;
- Zeilen 36–38: Initialisierung: die Namen der Tage und Monate in allen Sprachen, anschließend die Übersetzungen;
- Zeile 39: [ChangeNotifierProvider.value] stellt ein BEREITS erzeugtes Objekt bereit (von [main]);
- Zeile 50: der übersetzte Titel der Anwendung;
- Zeilen 52–54: Die Sprache von [Flutter] selbst folgt der Sprache der Anwendung;
- Zeilen 76–77: das Datum und der Preis, in der aktuellen Sprache formatiert und dann als Parameter an die Textbausteine übergeben;
- Zeilen 86–90: die Sprachauswahl in der oberen Leiste;
- Zeile 110: [count] wählt die Pluralform aus und ersetzt [{{count}}];
- Zeilen 124–128: der Kalender von [Flutter]: Seine Texte folgen der Sprache von [MaterialApp];
- Zeilen 144–146: was der Server [RdvMedecins] zurückliefern würde: einen Schlüssel und seine Parameter. Der Schlüssel des Servers IST ein Schlüssel des Wörterbuchs.
Auf Englisch (links); auf Französisch, nach einem Hinzufügen (Mitte); der Kalender auf Französisch (rechts):
![]() | ![]() | ![]() |
Ein Sprachwechsel zeichnet den gesamten Bildschirm neu, ohne Neustart und ohne Anfragen an den Server. Die gewählte Sprache wird auf dem Gerät gespeichert.


