Skip to content

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

{
  "APP": {
    "TITLE": "Exemple 21 - deux langues",
    "LANGUAGE": "Langue"
  },
  "HOME": {
    "HELLO": "Bonjour {{name}} !",
    "TODAY": "Nous sommes le {{date}}.",
    "PRICE": "Une consultation coûte {{price}}.",
    "APPOINTMENTS_zero": "aucun rendez-vous",
    "APPOINTMENTS_one": "un rendez-vous",
    "APPOINTMENTS_other": "{{count}} rendez-vous",
    "ADD": "Ajouter un rendez-vous",
    "REMOVE": "En retirer un",
    "CALENDAR": "Ouvrir le calendrier"
  },
  "ERRORS": {
    "LOGIN_TAKEN": "Ce login est déjà utilisé par un autre compte.",
    "TOO_MANY_ATTEMPTS": "Trop de tentatives infructueuses. Réessayez dans {{minutes}} minute(s)."
  },
  "SERVER": {
    "TITLE": "Traduire une réponse du serveur",
    "EXPLANATION": "Le serveur RdvMedecins ne renvoie que des clés. C'est le client qui les traduit :"
  }
}

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:

{
  "APP": {
    "TITLE": "Example 21 - two languages",
    "LANGUAGE": "Language"
  },
  "HOME": {
    "HELLO": "Hello {{name}}!",
    "TODAY": "Today is {{date}}.",
    "PRICE": "A consultation costs {{price}}.",
    "APPOINTMENTS_zero": "no appointment",
    "APPOINTMENTS_one": "one appointment",
    "APPOINTMENTS_other": "{{count}} appointments",
    "ADD": "Add an appointment",
    "REMOVE": "Remove one",
    "CALENDAR": "Open the calendar"
  },
  "ERRORS": {
    "LOGIN_TAKEN": "This login is already used by another account.",
    "TOO_MANY_ATTEMPTS": "Too many failed attempts. Try again in {{minutes}} minute(s)."
  },
  "SERVER": {
    "TITLE": "Translating a server response",
    "EXPLANATION": "The RdvMedecins server only sends keys. The client translates them:"
  }
}

7.1.2. Die Übersetzungen

// =========================================================================
// lib/ex21_i18n/translations.dart - Wörterbücher, eine aktuelle Sprache
// -------------------------------------------------------------------------
// Jede Sprache hat ihr WÖRTERBUCH, eine JSON-Datei, die mit der Anwendung ausgeliefert
// wird (assets/i18n/ex21_en.json, ex21_fr.json), in der jeder Text
// einen SCHLÜSSEL hat ("HOME.HELLO"):
//   - t('HOME.HELLO', {'name': 'Marie'}): der Text der AKTUELLEN
//     Sprache, dessen Parameter {{name}} ersetzt werden;
//   - t('HOME.APPOINTMENTS', {'count': n}): ein Text im Plural; wir
//     wählen den Schlüssel APPOINTMENTS_zero, _one oder _other je nach n und den Regeln
//     der Sprache (im Französischen sind 0 und 1 Singular; im Englischen
//     nur 1);
//   - changeLanguage('fr'): lädt das andere Wörterbuch und benachrichtigt die
//     Bildschirme (ein ChangeNotifier), die sich neu übersetzen.
// Das sind die Konventionen der JavaScript-Bibliothek i18next: Die
// Wörterbücher sind die der Vue.js-, Angular- und React-Clients von
// RdvMedecins ... und der Server, der nur SCHLÜSSEL zurückgibt
// ("ERRORS.LOGIN_TAKEN"), verwendet sie ebenfalls.
// =========================================================================

import 'dart:convert';

import 'package:flutter/services.dart';
import 'package:flutter/widgets.dart';
import 'package:intl/intl.dart';
import 'package:shared_preferences/shared_preferences.dart';

const languages = ['en', 'fr'];

class Translations extends ChangeNotifier {
  final String _prefix; // die Wörterbücher: assets/i18n/<prefix>_<language>.json
  final SharedPreferences? _storage;
  String _language = 'en';
  Map<String, Object?> _dictionary = {};

  Translations(this._prefix, [this._storage]);

  String get language => _language;

  // die Anfangssprache: die auf dem Gerät gespeicherte, sonst die des
  // Telefons (falls bekannt), sonst Englisch
  Future<void> start() async {
    final stored = _storage?.getString('$_prefix.language');
    final device = WidgetsBinding.instance.platformDispatcher.locale.languageCode;
    await changeLanguage(stored ?? (languages.contains(device) ? device : 'en'));
  }

  Future<void> changeLanguage(String language) async {
    // rootBundle: die mit der Anwendung ausgelieferten Dateien (Abschnitt assets der pubspec)
    final json = await rootBundle.loadString('assets/i18n/${_prefix}_$language.json');
    _dictionary = jsonDecode(json) as Map<String, Object?>;
    _language = language;
    await _storage?.setString('$_prefix.language', language);
    notifyListeners();
  }

  // "HOME.HELLO" -> dictionary['HOME']['HELLO']; null, falls nicht vorhanden
  String? _lookUp(String key) {
    Object? node = _dictionary;
    for (final part in key.split('.')) {
      node = node is Map<String, Object?> ? node[part] : null;
    }
    return node is String ? node : null;
  }

  String t(String key, [Map<String, Object?> params = const {}]) {
    String? text;
    final count = params['count'];
    if (count is int) {
      // Intl.pluralLogic: die Pluralform nach den Regeln der Sprache
      text = Intl.pluralLogic(
        count,
        locale: _language,
        zero: _lookUp('${key}_zero'),
        one: _lookUp('${key}_one'),
        other: _lookUp('${key}_other'),
      );
    }
    text ??= _lookUp(key);
    // ein unbekannter Schlüssel wird unverändert angezeigt: Was fehlt, sieht man sofort
    if (text == null) return key;
    // {{name}} -> der Wert des Parameters name
    return text.replaceAllMapped(RegExp(r'\{\{(\w+)\}\}'), (m) => '${params[m[1]] ?? m[0]}');
  }
}
  • 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

// =========================================================================
// lib/ex21_i18n/main.dart - eine Anwendung in zwei Sprachen
// -------------------------------------------------------------------------
//   - die TEXTE der Anwendung: die Wörterbücher (translations.dart),
//     allen Bildschirmen per provider bereitgestellt (siehe Beispiel 20);
//   - die Datums- und Betragsangaben: das Paket intl, in der aktuellen Sprache
//     (siehe Beispiel 09);
//   - die Texte von Flutter SELBST (der Kalender, seine Schaltflächen ...): die
//     Lokalisierungs-"Delegates" des Pakets flutter_localizations, die
//     der Eigenschaft locale von MaterialApp folgen.
// Ein Wechsel der Sprache übersetzt den ganzen Bildschirm neu, ohne Neustart.
// =========================================================================

import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:intl/date_symbol_data_local.dart';
import 'package:intl/intl.dart';
import 'package:provider/provider.dart';
import 'package:shared_preferences/shared_preferences.dart';

import 'translations.dart';

// was der RdvMedecins-Server zurückgeben würde (siehe das Kapitel über die Blackbox)
const serverResponses = [
  (statusCode: 409, key: 'ERRORS.LOGIN_TAKEN', params: <String, String>{}),
  (statusCode: 429, key: 'ERRORS.TOO_MANY_ATTEMPTS', params: {'minutes': '15'}),
];

// context.t('KEY'): eine Abkürzung über eine Extension von BuildContext
extension Translate on BuildContext {
  String t(String key, [Map<String, Object?> params = const {}]) => watch<Translations>().t(key, params);
}

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await initializeDateFormatting();
  final translations = Translations('ex21', await SharedPreferences.getInstance());
  await translations.start();
  runApp(ChangeNotifierProvider.value(value: translations, child: const Application()));
}

class Application extends StatelessWidget {
  const Application({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      // onGenerateTitle: der Titel der Anwendung, übersetzt
      onGenerateTitle: (context) => context.t('APP.TITLE'),
      theme: ThemeData(colorSchemeSeed: Colors.indigo),
      locale: Locale(context.watch<Translations>().language),
      supportedLocales: [for (final l in languages) Locale(l)],
      localizationsDelegates: GlobalMaterialLocalizations.delegates,
      home: const TranslatedPage(),
    );
  }
}

class TranslatedPage extends StatefulWidget {
  const TranslatedPage({super.key});

  @override
  State<TranslatedPage> createState() => _TranslatedPageState();
}

class _TranslatedPageState extends State<TranslatedPage> {
  int _count = 2;
  final _today = DateTime.now();

  @override
  Widget build(BuildContext context) {
    final translations = context.watch<Translations>();
    final language = translations.language;
    // Formatierer in der AKTUELLEN Sprache
    final date = DateFormat.yMMMMEEEEd(language).format(_today);
    final price = NumberFormat.currency(locale: language, name: 'EUR', symbol: '€').format(1234.5);

    return Scaffold(
      appBar: AppBar(
        title: Text(context.t('APP.TITLE')),
        actions: [
          // die Sprachen: "segmentierte" Schaltflächen
          Padding(
            padding: const EdgeInsets.only(right: 8),
            child: SegmentedButton<String>(
              showSelectedIcon: false,
              segments: [for (final l in languages) ButtonSegment(value: l, label: Text(l.toUpperCase()))],
              selected: {language},
              onSelectionChanged: (choice) => translations.changeLanguage(choice.first),
            ),
          ),
        ],
      ),
      body: ListView(
        padding: const EdgeInsets.all(16),
        children: [
          Card(
            child: Padding(
              padding: const EdgeInsets.all(12),
              child: Column(
                crossAxisAlignment: CrossAxisAlignment.start,
                children: [
                  Text(context.t('HOME.HELLO', {'name': 'Marie'})),
                  Text(context.t('HOME.TODAY', {'date': date})),
                  Text(context.t('HOME.PRICE', {'price': price})),
                  const SizedBox(height: 8),
                  // count: wählt die Pluralform und ersetzt {{count}}
                  Text(
                    context.t('HOME.APPOINTMENTS', {'count': _count}),
                    style: const TextStyle(fontWeight: FontWeight.bold),
                  ),
                  Wrap(
                    spacing: 8,
                    children: [
                      TextButton(onPressed: () => setState(() => _count++), child: Text(context.t('HOME.ADD'))),
                      TextButton(
                        onPressed: _count == 0 ? null : () => setState(() => _count--),
                        child: Text(context.t('HOME.REMOVE')),
                      ),
                    ],
                  ),
                  // der Kalender von Flutter: Seine Texte folgen der Sprache von MaterialApp
                  OutlinedButton.icon(
                    icon: const Icon(Icons.calendar_month),
                    label: Text(context.t('HOME.CALENDAR')),
                    onPressed: () =>
                        showDatePicker(context: context, firstDate: DateTime(2026), lastDate: DateTime(2027, 12, 31)),
                  ),
                ],
              ),
            ),
          ),
          Card(
            child: Padding(
              padding: const EdgeInsets.all(12),
              child: Column(
                crossAxisAlignment: CrossAxisAlignment.start,
                children: [
                  Text(context.t('SERVER.TITLE'), style: Theme.of(context).textTheme.titleSmall),
                  Text(context.t('SERVER.EXPLANATION')),
                  const SizedBox(height: 8),
                  // der Schlüssel des Servers IST ein Schlüssel des Wörterbuchs; params liefert seine Parameter
                  for (final r in serverResponses) ...[
                    Text('${r.statusCode} ${r.key}', style: const TextStyle(fontFamily: 'RobotoMono', fontSize: 12)),
                    Text('→ ${context.t(r.key, r.params)}'),
                    const SizedBox(height: 6),
                  ],
                ],
              ),
            ),
          ),
        ],
      ),
    );
  }
}
  • 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.