Flutter ARB
Překládejte hodnoty zpráv v ARB a zachovejte metadata prostředků i definice zástupných symbolů.
Application Resource Bundle neboli ARB uchovává zprávy pro Flutter spolu s jejich popisy a definicemi zástupných symbolů. Obslužná rutina pro soubory flutter překládá položky obsahující prosté řetězce v tomto plochém objektu JSON a klíče začínající na @ zachovává jako metadata.
Zprávy a metadata #
Například zpráva o doručení může deklarovat číslo, které přijímá jako parametr:
{
"@@locale": "en",
"delivery": "Delivery within {days} days",
"@delivery": {
"description": "Checkout estimate for the latest arrival date",
"placeholders": {
"days": { "type": "int" }
}
}
}delivery se stává překladovou jednotkou. Sousední položka @delivery.description slouží jako nápověda pro překladatele a ve výstupu zůstává jako metadata. Definice zástupných symbolů se přenášejí beze změny, nepřekládají se. Obslužná rutina nepovažuje libovolné vnořené objekty za další katalogy zpráv.
Pokud @@locale existuje a je zadán cílový jazyk, při rekonstrukci se aktualizuje. Chybějící @@locale se automaticky nepřidává. Ostatní globální položky balíčku si zachovávají hodnoty ze zdroje.
Stávající hodnoty a rozsah #
Předchozí verze zdroje slouží k rozpoznání změn zpráv podle klíče. Stávající cílový soubor může poskytnout schválené hodnoty. Při rekonstrukci se používají metadata aktuálního zdroje, takže se jejich změny mohou projevit ve výstupu i při opětovném použití stávajícího znění zpráv.
Změněné zprávy zpracujte běžnou aktualizací zdroje. Po změně pokynů pro překlad můžete cíleně obnovit celý soubor; viz Rozsahy CLI. Před spuštěním generování pro Flutter zkontrolujte výsledné zprávy a metadata.
Výstupní JSON používá odsazení dvěma mezerami a končí znakem nového řádku. Jde o rekonstrukci struktury, nikoli o zachování původního formátování bajt po bajtu.
Přeložte zprávy a poté vygenerujte prostředky pro Flutter #
CLI odvodí flutter z .arb. Ze zdroje, jako je app_en.arb, vzniknou soubory pro jednotlivé jazyky, například app_de.arb; tyto cesty slaďte s konfigurací lokalizace projektu. Výběr souborů nastavíte pomocí konfigurace CLI nebo GitHub.
Po stažení spusťte v projektu generátor lokalizace pro Flutter a kontroly sestavení. Zobrazte parametrizované zprávy se skutečnými hodnotami a v každém cílovém jazyce otestujte jednotlivé tvary množného čísla. Zachovaná metadata říkají generátoru, co má očekávat; i přeložená zpráva však musí tyto zástupné symboly používat správně. Návod Lokalizace aplikace Flutter vás provede i tímto ověřením prostředků v aplikaci.