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:
<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:
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 linkV .lingo/config.json ponechte ID propojené organizace a lokalizačního engine a poté výslovně nastavte formát souboru:
{
"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ý jazyk | Cílový adresář |
|---|---|
es | values-es |
pt-BR | values-pt-rBR |
zh-Hans | values-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:
lingo push --backfill-missing --waitPoč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í:
lingo push --waitChcete-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:
lingo push "app/src/main/res/values/strings.xml" --force --waitTí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í.