Flutter-Lokalisierung: ARB-Dateien, intl und gen-l10n erklärt

Verwenden Sie einen einzigen Lokalisierungsgenerator und legen Sie dessen Ein- und Ausgabeorte explizit fest. Das folgende Beispiel setzt eine bestehende Flutter-Anwendung mit eigenen SDK-Einschränkungen und normaler Projektkonfiguration voraus.

Übernehmen Sie die relevanten Einträge in pubspec.yaml; duplizieren Sie nicht die Abschnitte dependencies oder flutter:

dependencies:
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter
  intl: any

flutter:
  generate: true

Lösen Sie die Abhängigkeiten mit flutter pub get auf. Der Eintrag intl: any folgt dem offiziellen Einrichtungsmuster, sodass die Abhängigkeitsauflösung die mit dem Flutter SDK kompatible Version wählen kann; behalten Sie die Lockfile der Anwendung und den üblichen Prüfprozess für Abhängigkeiten bei.

Erstellen Sie l10n.yaml im Stammverzeichnis des Projekts:

arb-dir: lib/l10n
template-arb-file: app_en.arb
output-localization-file: app_localizations.dart

Nutzen Sie den aktuellen Flutter-Leitfaden zur Internationalisierung für die SDK-spezifische Einrichtung. Generierte Lokalisierungsdateien gehören im modernen Workflow in den Quellbaum der Anwendung. Das Beispiel importiert aus lib/l10n; übernehmen Sie keinen alten synthetischen Import von package:flutter_gen in eine neue Einrichtung. Siehe den Migrationshinweis zu generiertem Quellcode.

Erstellen Sie lib/l10n/app_en.arb:

{
  "@@locale": "en",
  "appTitle": "Reading room",
  "@appTitle": {
    "description": "Title of the sample reading application"
  },
  "welcomeName": "Welcome, {name}",
  "@welcomeName": {
    "description": "Greeting on the home screen",
    "placeholders": {
      "name": {"type": "String", "example": "Sam"}
    }
  },
  "savedBooks": "{count, plural, =0{No saved books} one{1 saved book} other{{count} saved books}}",
  "@savedBooks": {
    "description": "Number of books saved to the user's library",
    "placeholders": {
      "count": {"type": "int"}
    }
  },
  "readingState": "{state, select, active{Reading now} paused{Reading paused} other{Ready to read}}",
  "@readingState": {
    "description": "Reading status; state is active, paused or another value",
    "placeholders": {
      "state": {"type": "String"}
    }
  }
}

Erstellen Sie lib/l10n/app_es.arb:

{
  "@@locale": "es",
  "appTitle": "Sala de lectura",
  "welcomeName": "Te damos la bienvenida, {name}",
  "savedBooks": "{count, plural, =0{No hay libros guardados} one{1 libro guardado} other{{count} libros guardados}}",
  "readingState": "{state, select, active{Leyendo ahora} paused{Lectura en pausa} other{Todo listo para leer}}"
}

Die Vorlage enthält die vom Generator verwendeten Platzhalter-Metadaten. Die lokalisierte Datei behält Meldungsschlüssel, Platzhalternamen und Select-Bezeichner bei und ändert nur die nutzersichtbare Formulierung. Diese spanischen Beispiele veranschaulichen die Mechanik; produktive Texte sollten im tatsächlichen Produktkontext muttersprachlich geprüft werden.

Führen Sie flutter gen-l10n aus, nachdem Sie Ressourcen hinzugefügt oder geändert haben. Behandeln Sie Generatorfehler als konkrete Ressourcenprobleme und beheben Sie sie, bevor Sie die Dateien in ein Release übernehmen.

Das folgende Beispiel gehört nach der Generierung in lib/main.dart:

import 'package:flutter/material.dart';
import 'l10n/app_localizations.dart';

void main() => runApp(const ReadingApp());

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      localizationsDelegates: AppLocalizations.localizationsDelegates,
      supportedLocales: AppLocalizations.supportedLocales,
      home: const ReadingHome(),
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    final messages = AppLocalizations.of(context)!;
    return Scaffold(
      appBar: AppBar(title: Text(messages.appTitle)),
      body: Padding(
        padding: const EdgeInsetsDirectional.all(16),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text(messages.welcomeName('Sam')),
            Text(messages.savedBooks(3)),
            Text(messages.readingState('active')),
          ],
        ),
      ),
    );
  }
}

Die generierte API macht den Unterschied zwischen einer einfachen Meldung und einer Meldung mit Argumenten im Code sichtbar. Auf appTitle wird als Wert zugegriffen; welcomeName, savedBooks und readingState erhalten die Werte, die zum Aufbau ihrer Meldungen nötig sind.

Lesen Sie vor der Entscheidung die aktuelle Dokumentation zu easy_localization und die GetX-Dokumentation. Testen Sie Fallback-Verhalten, Parameter, Pluralkategorien und Extraktions-Workflows mit Ihren echten Meldungen. Eine bequeme API für englische Strings beweist nicht, dass jede Sprache abgedeckt ist, die Sie ausliefern möchten.

intl ist keine konkurrierende Plattform für Übersetzungsmanagement. Es liefert Internationalisierungswerkzeuge, die Lokalisierungs-Workflows nutzen. gen-l10n erzeugt aus ARB-Ressourcen Zugriffsmethoden für die Anwendung. Das separate Paket intl_utils erzeugt ebenfalls Lokalisierungscode, doch seine Paketseite war bei der Prüfung am 30. Oktober 2026 als eingestellt markiert. Prüfen Sie den Wartungsstatus, bevor Sie es in einem neuen Projekt einsetzen.

Verwenden Sie eine praxisnahe Testmatrix:

Die Web-FAQ von Flutter beschreibt den Fokus auf Anwendungserlebnisse und empfiehlt für statische, textreiche Webinhalte einen dokumentorientierten Ansatz. Erwägen Sie separate HTML-basierte Marketing-, Hilfe- und Redaktionsseiten, wenn diese in der organischen Suche gut abschneiden sollen.

Halten Sie die Terminologie zwischen App und diesen öffentlichen Seiten einheitlich. Ein Besucher aus der Suche sollte den Funktionsnamen wiedererkennen, wenn er von der lokalisierten Landingpage in die Anwendung wechselt, auch wenn beide Oberflächen unterschiedliche Rendering-Systeme nutzen.

Zu den dokumentierten Softwareprojektformaten von Smartcat gehören JSON, YAML, Android-XML, iOS-.strings und LocJSON-Importe. Die für diesen Leitfaden geprüfte Dokumentation belegt weder native ARB-Unterstützung noch einen getesteten ARB-zu-JSON-Konvertierungsprozess. Gehen Sie nicht davon aus, dass eine geänderte Dateierweiterung Kompatibilität beweist. Siehe die Dokumentation zu Softwareprojekten.

Nutzen Sie Folgendes als vorgeschlagenes Validierungsverfahren mit Ihrem Implementierungsteam, nicht als bereits getestetes Connector-Rezept: