Communitygithub.com

Flutter-Internationalisierung einrichten

Füge die Abhängigkeiten `flutter_localizations` und `intl` hinzu, aktiviere `generate: true` in der `pubspec.yaml` und erstelle eine `l10n.yaml`-Konfigurationsdatei. Verwende dies, wenn du die Lokalisierungsunterstützung für ein neues Flutter-Projekt initialisierst.

Was ist Flutter-Internationalisierung einrichten?

Diese Fähigkeit automatisiert die Einrichtung der Internationalisierung (i18n) und Lokalisierung (l10n) in Flutter-Projekten. Sie führt dich durch die Installation der Pakete `flutter_localizations` und `intl`, die Aktivierung der Code-Generierung in der `pubspec.yaml` und die Erstellung einer `l10n.yaml`-Konfiguration. Du definierst übersetzte Zeichenketten in `.arb`-Dateien (z.B. `app_en.arb`), woraus automatisch eine typsichere `AppLocalizations`-Klasse generiert wird. Der Skill behandelt auch fortgeschrittene Formatierungen wie Platzhalter, Pluralformen und geschlechtsabhängige Ausdrücke. Er ist plattformunabhängig und funktioniert mit jeder Flutter-App. Die Anleitung umfasst die Konfiguration von `MaterialApp` oder `CupertinoApp` sowie die Verwendung der generierten lokalen Zeichenketten im Widget-Baum.

Funktioniert mit~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/dbillion/hermes-skills-public/tree/HEAD/skills-external/flutter-setup-localization

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Internationalisierung von Flutter-Anwendungen

Inhalt

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.yaml hinzufügen.
    • 2. Das generate-Flag aktivieren.
    • 3. Die Konfigurationsdatei l10n.yaml erstellen.
    • 4. MaterialApp oder CupertinoApp konfigurieren.

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)),
      ],
    );
  }
}

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

dbillion/hermes-skills-public

Edit an existing image based on a text prompt.

dbillion/hermes-skills-public

Expert in video composition, editing, and format conversion. Use when the user wants to generate high-quality video, overlay images on video, concatenate clips, create GIFs, or sync audio to video using mcp-avtool-go and mcp-veo-go.

dbillion/hermes-skills-public

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

dbillion/hermes-skills-public

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

dbillion/hermes-skills-public

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

dbillion/hermes-skills-public

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Verwandte Skills