Lokalizujte aplikaci pro Android

Přeložte prostředky Androidu, umístěte je do správných jazykových adresářů a ověřte texty v aplikaci.

Android vybírá lokalizované texty z adresářů prostředků, zatímco kód aplikace dál používá stejné názvy prostředků. Lingo.dev tyto prostředky překládá do cílových adresářů. Pro začátek vezměte z výchozího souboru prostředků jeden pozdrav, jeden seznam a jeden prostředek s množnými tvary a zobrazte je na obrazovce spuštěné v jiném jazyce.

Tento postup použijte pro nativní prostředky Androidu ve formátu XML. Pro Flutter se řiďte návodem Prostředky ARB a generovaný lokalizační kód, pro katalogy JSON návodem Lokalizace v React Native.

Připravte prostředky, které obrazovka načítá #

Výchozí prostředky uchovávejte v app/src/main/res/values/strings.xml:

xml
<resources>
  <string name="welcome">Welcome, %1$s!</string>
  <string name="product_name" translatable="false">ExampleApp</string>
  <string-array name="delivery_options">
    <item>Standard delivery</item>
    <item>Express delivery</item>
  </string-array>
  <plurals name="items_count">
    <item quantity="one">%d item</item>
    <item quantity="other">%d items</item>
  </plurals>
</resources>

Propojte tyto prostředky s obrazovkou pomocí stávajících volání prostředků v aplikaci. welcome identifikuje text a %1$s přijímá jméno předané z kódu. Prostředek s množnými tvary potřebuje počet pro výběr správného tvaru i pro formátování. translatable="false" zajistí, že se název produktu nebude překládat.

Nástroj pro zpracování souborů Androidu vybírá položky s prostým textem a přeskakuje ty, které kombinují text s vnořenými značkami. Pokud text obsahuje podřízené prvky, například <b> nebo <xliff:g>, řešte tyto položky samostatně. Text v sekci CDATA lze přeložit při zachování jejího obalu; značky uvnitř se považují za text, nikoli za chráněnou strukturu podřízených prvků. Prostředky s formátováním zkontrolujte přímo při vykreslení v aplikaci.

Nastavte výběr zdrojů a cesty pro jednotlivé jazyky #

V kořenovém adresáři projektu nainstalujte a propojte CLI:

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,pt-BR,zh-Hans --files 'app/src/main/res/values/strings.xml' --yes
lingo link

V .lingo/config.json ponechte ID propojené organizace a lokalizačního engine a poté výslovně nastavte formát souboru:

json
{
  "pattern": "app/src/main/res/values/strings.xml",
  "format": "android"
}

Tento objekt použijte jako položku souboru. Samotná přípona .xml nestačí k rozlišení prostředků Androidu od jiných struktur XML. Přidejte zdrojové položky pro další soubory prostředků, například arrays.xml, ale nezahrnujte generované cílové adresáře.

Aktuální verze CLI rozpoznává adresář values/ bez kvalifikátoru a v cílových cestách používá kvalifikátory Androidu:

Cílový jazykCílový adresář
esvalues-es
pt-BRvalues-pt-rBR
zh-Hansvalues-b+zh+Hans

Symbolický odkaz values-en není pro toto uspořádání potřeba. Pokud ho používala starší konfigurace, před jeho odstraněním konfiguraci aktualizujte a zkontrolujte. Adresář zadaný přímo jako values-pt-BR nepoužívá očekávaný regionální kvalifikátor. Výslovné nastavení cílových cest a zápis jazykových kódů popisuje Konfigurace CLI.

Přeložte a načtěte první cílový jazyk #

Pro chybějící cílové soubory spusťte:

sh
lingo push --backfill-missing --wait

Počkejte na dokončení běhu včetně případné nastavené kontroly a prohlédněte si stažené XML. Porovnejte se zdrojem názvy prostředků, pořadí položek v polích, atributy určující množství, pevně daný název produktu a specifikátory formátu. Pokud nepoužijete --wait, stáhněte výsledek dokončeného běhu pomocí lingo pull v tom checkout, ze kterého jste běh odeslali.

Sestavte aplikaci pomocí konfigurace Gradle v projektu a poté ji spusťte na zařízení nebo emulátoru s nastaveným cílovým jazykem. Otevřete obrazovku a zadejte jméno a několik různých počtů. Úspěšné sestavení ověří syntaxi prostředků a odkazy na ně; kontrola na zařízení potvrdí, že Android skutečně vybral adresář s překladem.

Zkontrolujte výstup pro počty, které pokrývají jednotlivé kategorie množných tvarů cílového jazyka. Nástroj pro zpracování zachovává strukturu množných tvarů ze zdroje, takže anglické one a other nezajistí úplnou sadu tvarů v cílovém jazyce. Zkontrolujte dlouhé popisky, texty pro přístupnost a podle potřeby i rozložení zprava doleva. lingo check nenahrazuje kontroly prostředků Androidu ani jejich úplnosti.

Pokračujte při změnách zdroje #

Zdroj, schválené cílové překlady, propojenou konfiguraci a .lingo/lock.json uložte společně do commitu. Po úpravě zdrojových řetězců přeložte změny pomocí:

sh
lingo push --wait

Chcete-li po změně pokynů pro engine znovu vygenerovat všechny překlady jednoho zdrojového souboru, uložte schválené cílové překlady a spusťte:

sh
lingo push "app/src/main/res/values/strings.xml" --force --wait

Tím nahradíte překlady vybraného souboru v nastavených cílových jazycích. Výběr souborů a opětovné generování popisuje návod Rozsahy CLI.

Uchovejte si porovnání cílových překladů před změnou a po ní. Pevně dané prostředky Androidu označte pomocí translatable="false", jako v příkladu s názvem produktu výše. Před opětovným generováním uložte stávající opravy. Chcete-li odhalit úpravy cílových překladů provedené po odeslání, vynechte --wait a před stažením zkontrolujte lingo pull --dry-run. Tuto kontrolu a řešení konfliktů vysvětluje návod Zachování zkontrolovaných překladů.

Jakmile bude jedna obrazovka fungovat, použijte pro pravidelné překlady GitHub App nebo běhové prostředí CI. Běhové prostředí zajišťuje ověřování a zpětný zápis změn, které lze zkontrolovat; před schválením je ale stále nutné sestavit aplikaci pro Android a zkontrolovat reprezentativní obrazovky. Překlady uložené do commitu jinde se přenesou prostřednictvím správy verzí, zatímco lingo pull stáhne výsledek lokálně zaznamenaného odeslání.