Lokalizace aplikace ve Flutter

Přeložte zprávy ARB, vygenerujte prostředky pro Flutter a zkontrolujte výslednou obrazovku v každém cílovém jazyce.

Lokalizační nástroje Flutter převádějí zprávy ARB na metody, které volají vaše widgety. Lingo.dev tyto prostředky ARB překládá, takže můžete přidávat jazyky a přitom zachovat stejné generované API. Začněte jednou obrazovkou s pozdravem a počtem položek, na které najednou ověříte text, proměnné i tvary množného čísla.

Tento postup předpokládá, že projekt už načítá zdrojový soubor ARB prostřednictvím generování lokalizace ve Flutter. Zachovejte stávající l10n.yaml, generátor i volání ve widgetech. Lingo.dev zde zajišťuje překlad souborů; výběr jazyka a vykreslování zpráv má nadále na starosti Flutter.

Doplňte ke každé zprávě potřebné informace #

Pro zdrojový soubor v lib/l10n/app_en.arb použijte například tento katalog:

json
{
  "@@locale": "en",
  "welcome": "Welcome, {name}",
  "@welcome": {
    "description": "Greeting on the signed-in account screen",
    "placeholders": { "name": { "type": "String" } }
  },
  "itemCount": "{count, plural, =0{No items} =1{One item} other{{count} items}}",
  "@itemCount": {
    "description": "Number of items in the cart",
    "placeholders": { "count": { "type": "int" } }
  }
}

Popis překladateli vysvětluje, k čemu zpráva slouží. Definice zástupných symbolů sdělují nástrojům Flutter, jaké hodnoty předává volající kód. Obslužný modul ARB přeloží oba řetězce zpráv, zachová metadata a nastaví stávající pole @@locale na cílový jazyk.

Nejprve spusťte lokalizační generátor projektu nad zdrojovým katalogem a na obrazovce použijte vygenerované metody pro pozdrav a počet položek. Ještě před přidáním dalšího jazyka tak ověříte, že původní katalog a volající kód jsou v souladu.

V kořenovém adresáři projektu nainstalujte aktuální verzi CLI a přihlaste se:

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets de,fr --files 'lib/l10n/app_en.arb' --yes
lingo link

init zapíše .lingo/config.json; link vybere organizaci a lokalizační engine. Vygenerované identifikátory zachovejte. Pole pro lokalizaci by měla vybírat pouze zdrojový soubor:

json
{
  "sourceLocale": "en",
  "targetLocales": ["de", "fr"],
  "files": [
    { "pattern": "lib/l10n/app_en.arb", "format": "flutter" }
  ]
}

Jde o lokalizační část propojené konfigurace, nikoli o náhradu jejích identifikátorů organizace a lokalizačního engine. Přípona .arb také automaticky vybere flutter. Při tomto uspořádání vzniknou app_de.arb a app_fr.arb; ověřte, že je generátor projektu načítá. Pro jiné uspořádání nastavte explicitní cílovou cestu.

Vyhněte se vzoru pro výběr zdrojových souborů, jako je app_*.arb, který zahrnuje i přeložené katalogy. U regionálních jazykových variant slaďte zápis názvů souborů s konfigurací projektu Flutter. Nepředpokládejte, že každý identifikátor jazyka bude v názvu souboru fungovat beze změny.

Přeložte a vygenerujte cílové prostředky #

Pokud cílové soubory chybí, spusťte:

sh
lingo push --backfill-missing --wait

Příkaz počká na dokončení a stáhne soubory. Pokud běh čeká na kontrolu nebo selže, vyřešte tento stav, než začnete generovat prostředky pro vydání. Samotné první odeslání může nastavit výchozí stav zdroje, aniž by vyžádalo tyto chybějící překlady.

V cílových souborech zkontrolujte klíče, popisy, názvy a typy zástupných symbolů a @@locale. Poté v projektu spusťte generování lokalizace Flutter, analýzu, testy a sestavení. Než budete pokračovat, opravte všechny neplatné výrazy ICU, chybějící zástupné symboly a nekompatibilní typy. Rekonstrukce ARB zachovává metadata, ale neověřuje platnost každé přeložené zprávy pro generátor Flutter.

Otevřete obrazovku v němčině a francouzštině. Vyzkoušejte krátké i dlouhé jméno a potom počty 0, 1, 2 a větší číslo. Zkontrolujte samotné znění tvarů množného čísla, ne jen to, zda se zobrazilo číslo. Cílové jazyky mohou vyžadovat další kategorie, které anglický zdroj nemá, proto zkontrolujte všechny potřebné cílové tvary. Ověřte výběr jazyka, použití náhradního jazyka, prodloužení textu a případně i směr psaní. Formátování dat a čísel nadále určuje Flutter za běhu.

I další aktualizace provádějte v návaznosti na zdroj #

Uchovávejte konfiguraci, zdroj, přijaté cílové překlady a .lingo/lock.json společně. Po změně zdrojové zprávy spusťte lingo push --wait a zkontrolujte ji vedle sousední nezměněné zprávy. Samotná úprava popisu nevytvoří nový požadavek na překlad textu zprávy; pokud má upravený kontext vést k novému překladu, použijte aktualizaci s omezeným rozsahem.

Neupravujte cílové soubory, dokud čekají na zpětný zápis. Chcete-li ochránit ruční opravy cílových překladů, odešlete úlohu bez --wait, zkontrolujte lingo pull --dry-run a poté stáhněte výsledky pomocí lingo pull ve stejném checkout, ze kterého jste úlohu odeslali. Na ostatních počítačích je potřeba mít překlady uložené v commitu nebo výslovně předané jako artefakty; nelze předpokládat, že sdílejí poslední běh. Podrobnosti o obnově najdete v části Zachování zkontrolovaných překladů.

Jakmile tento cyklus funguje, použijte GitHub App nebo automatizaci CI, aby se překlad a generování prostředků před kontrolou opakovaly. Nativní Android XML a prostředky Apple mají odlišné požadavky na soubory i chování za běhu; v multiplatformním projektu je proto udržujte odděleně od generování ARB.