Flutter-lokalisering: ARB-filer, intl och gen-l10n förklarade

Använd en enda lokaliseringsgenerator och ange tydligt var dess in- och utdata finns. Exemplet nedan förutsätter en befintlig Flutter-applikation med egna SDK-begränsningar och normal projektkonfiguration.

Slå samman relevanta poster i pubspec.yaml; duplicera inte avsnitten dependencies eller flutter:

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

flutter:
  generate: true

Hämta beroenden med flutter pub get. Posten intl: any följer det officiella konfigurationsmönstret och låter beroendeupplösningen välja den version som är kompatibel med Flutter SDK; behåll applikationens låsfil och er normala process för granskning av beroenden.

Skapa l10n.yaml i projektets rot:

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

Använd den aktuella guiden för internationalisering i Flutter för SDK-specifik konfiguration. Genererade lokaliseringsfiler hör hemma i applikationens källträd i det moderna arbetsflödet. Exemplet importerar från lib/l10n; undvik att kopiera en gammal syntetisk package:flutter_gen-import till en ny konfiguration. Se migreringsanteckningen om genererad källkod.

Skapa 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"}
    }
  }
}

Skapa 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}}"
}

Mallen innehåller den platshållarmetadata som generatorn använder. Den lokaliserade filen bevarar meddelandenycklar, platshållarnamn och select-identifierare medan den användarvända formuleringen ändras. De spanska exemplen illustrerar mekaniken; produktionstext bör granskas av modersmålstalare i sitt faktiska produktsammanhang.

Kör flutter gen-l10n efter att du har lagt till eller ändrat resurser. Behandla generatorfel som konkreta resursproblem och åtgärda dem innan filerna integreras i en release.

Följande exempel hör hemma i lib/main.dart efter genereringen:

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

Det genererade API:t gör skillnaden mellan ett enkelt meddelande och ett meddelande med argument synlig i koden. appTitle nås som ett värde; welcomeName, savedBooks och readingState tar emot de värden som behövs för att bygga meddelandena.

Läs den aktuella dokumentationen för easy_localization och dokumentationen för GetX innan du väljer. Testa reservbeteende, parametrar, pluralkategorier och extraheringsflöden med era riktiga meddelanden. Ett bekvämt API för engelska strängar bevisar inte täckning för alla språk ni planerar att lansera.

intl är ingen konkurrerande plattform för översättningshantering. Paketet tillhandahåller internationaliseringsverktyg som används i lokaliseringsarbetsflöden. gen-l10n genererar applikationsaccessorer från ARB-resurser. Det separata paketet intl_utils genererar också lokaliseringskod, men dess paketsida var markerad som avvecklad vid kontroll den 30 oktober 2026. Kontrollera underhållsstatusen innan du använder det i ett nytt projekt.

Använd en praktisk testmatris:

Flutters vanliga frågor om web beskriver fokus på applikationsupplevelser och rekommenderar ett dokumentorienterat angreppssätt för statiskt, textrikt webbinnehåll. Överväg separata HTML-baserade sidor för marknadsföring, hjälp och redaktionellt innehåll när de sidorna behöver prestera i organisk sökning.

Håll terminologin samstämmig mellan appen och de offentliga sidorna. En besökare från sökningen ska känna igen funktionsnamnet när hen går från den lokaliserade landningssidan till applikationen, även om de två ytorna renderas med olika system.

Smartcats dokumenterade format för programvaruprojekt omfattar import av JSON, YAML, Android XML, iOS .strings och LocJSON. Den dokumentation som granskades för den här guiden visar inte inbyggt stöd för ARB eller ett testat arbetsflöde för konvertering från ARB till JSON. Utgå inte från att en ändrad filändelse bevisar kompatibilitet. Se dokumentationen för programvaruprojekt.

Använd följande som ett förslag på valideringsprocedur tillsammans med ert implementeringsteam, inte som ett redan testat recept för en koppling: