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:

json
{
  "@@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.