Internationalisierung von Flutter-Anwendungen
Inhalt
- Grundlegende Konzepte
- Einrichtungsworkflow
- Implementierungsworkflow
- Fortgeschrittene Formatierung
- Beispiele
Grundlegende Konzepte
Flutter handelt Internationalisierung (i18n) und Lokalisierung (l10n) über die Pakete flutter_localizations und intl. Der Standardansatz verwendet App-Ressourcenbündel-Dateien (.arb), um lokalisierte Zeichenketten zu definieren. Diese werden dann in eine generierte Klasse AppLocalizations kompiliert, die einen typsicheren Zugriff innerhalb des Widget-Baums ermöglicht.
Einrichtungsworkflow
Kopiere und verfolge diese Checkliste, wenn du die Internationalisierung in einem Flutter-Projekt initialisierst:
- Aufgabenfortschritt
- 1. Abhängigkeiten zur
pubspec.yamlhinzufügen. - 2. Das
generate-Flag aktivieren. - 3. Die Konfigurationsdatei
l10n.yamlerstellen. - 4.
MaterialAppoderCupertinoAppkonfigurieren.
- 1. Abhängigkeiten zur
1. Abhängigkeiten hinzufügen
Füge die erforderlichen Lokalisierungspakete zum Projekt hinzu. Führe die folgenden Befehle im Terminal aus:
flutter pub add flutter_localizations --sdk=flutter
flutter pub add intl:any
Stelle sicher, dass deine pubspec.yaml die folgenden Zeilen unter dependencies enthält:
dependencies:
flutter:
sdk: flutter
flutter_localizations:
sdk: flutter
intl: any
2. Code-Generierung aktivieren
Öffne die pubspec.yaml und aktiviere das generate-Flag im flutter-Abschnitt, um Lokalisierungsaufgaben zu automatisieren:
flutter:
generate: true
3. Konfigurationsdatei erstellen
Erstelle eine neue Datei namens l10n.yaml im Stammverzeichnis des Flutter-Projekts. Definiere das Eingabeverzeichnis, die Vorlagendatei und die Ausgabedatei:
arb-dir: lib/l10n
template-arb-file: app_en.arb
output-localization-file: app_localizations.dart
synthetic-package: true
4. App-Einstiegspunkt konfigurieren
Importiere die generierten Lokalisierungen und die Bibliothek flutter_localizations in deiner main.dart. Füge die Delegaten und unterstützten Gebietsschemata in deine MaterialApp oder CupertinoApp ein.
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:flutter_gen/gen_l10n/app_localizations.dart'; // Pfad anpassen, wenn synthetic-package false ist
// ... innerhalb der build-Methode
return MaterialApp(
localizationsDelegates: const [
AppLocalizations.delegate,
GlobalMaterialLocalizations.delegate,
GlobalWidgetsLocalizations.delegate,
GlobalCupertinoLocalizations.delegate,
],
supportedLocales: const [
Locale('en'), // Englisch
Locale('es'), // Spanisch
],
home: const MyHomePage(),
);
Implementierungsworkflow
Befolge diesen Workflow, wenn du lokalisierte Inhalte hinzufügst oder änderst.
1. ARB-Dateien definieren
- Wenn du NEUE Inhalte erstellst: Füge die Basiszeichenkette zur Vorlagendatei (
lib/l10n/app_en.arb) hinzu. Gib eine Beschreibung für den Kontext an. - Wenn du VORHANDENE Inhalte bearbeitest: Suche den Schlüssel in allen unterstützten
.arb-Dateien und aktualisiere die Werte.
{
"helloWorld": "Hallo Welt!",
"@helloWorld": {
"description": "Der konventionelle Gruß des Programmieranfängers"
}
}
Erstelle entsprechende Dateien für andere Gebietsschemata (z.B. app_es.arb):
{
"helloWorld": "¡Hola Mundo!"
}
2. Lokalisierungsklassen generieren
Führe den folgenden Befehl aus, um die Code-Generierung auszulösen:
flutter pub get
Rückkopplungsschleife: Führe den Validator aus -> überprüfe die Terminalausgabe auf ARB-Syntaxfehler -> behebe fehlende Kommas oder nicht übereinstimmende Platzhalter -> führe flutter pub get erneut aus.
3. Lokalisierte Zeichenketten verwenden
Greife mit AppLocalizations.of(context) auf die lokalisierten Zeichenketten in deinem Widget-Baum zu. Stelle sicher, dass das aufrufende Widget ein Nachkomme von MaterialApp ist.
Text(AppLocalizations.of(context)!.helloWorld)
Fortgeschrittene Formatierung
Verwende Platzhalter für dynamische Daten, Pluralformen und bedingte Auswahlen.
Platzhalter
Definiere Parameter in geschweiften Klammern und gib ihren Typ im Metadatenobjekt an.
"hello": "Hallo {userName}",
"@hello": {
"description": "Eine Nachricht mit einem einzelnen Parameter",
"placeholders": {
"userName": {
"type": "String",
"example": "Bob"
}
}
}
Pluralformen
Verwende die plural-Syntax, um mengengesteuerte Zeichenkettenvarianten zu handhaben. Der Fall other ist obligatorisch.
"nWombats": "{count, plural, =0{keine Wombats} =1{ein Wombat} other{{count} Wombats}}",
"@nWombats": {
"description": "Eine Plural-Nachricht",
"placeholders": {
"count": {
"type": "num",
"format": "compact"
}
}
}
Auswahl (Selects)
Verwende die select-Syntax für bedingte Zeichenketten, wie z.B. geschlechtsabhängigen Text.
"pronoun": "{gender, select, male{er} female{sie} other{sie}}",
"@pronoun": {
"description": "Eine geschlechtsabhängige Nachricht",
"placeholders": {
"gender": {
"type": "String"
}
}
}
Beispiele
Vollständige l10n.yaml
arb-dir: lib/l10n
template-arb-file: app_en.arb
output-localization-file: app_localizations.dart
synthetic-package: true
use-escaping: true
Vollständige Widget-Implementierung
import 'package:flutter/material.dart';
import 'package:flutter_gen/gen_l10n/app_localizations.dart';
class GreetingWidget extends StatelessWidget {
final String userName;
final int notificationCount;
const GreetingWidget({
super.key,
required this.userName,
required this.notificationCount,
});
@override
Widget build(BuildContext context) {
final l10n = AppLocalizations.of(context)!;
return Column(
children: [
Text(l10n.hello(userName)),
Text(l10n.nWombats(notificationCount)),
],
);
}
}