Lokalizace aplikace pro iOS
Přeložte katalogy řetězců Apple nebo starší prostředky bez ztráty jazyků ve sdílených souborech a výsledek ověřte v Xcode i v aplikaci.
Aplikace pro iOS může dál používat stejná volání pro načítání lokalizovaných řetězců, i když do jejích souborů prostředků přidáte další jazyk. Lingo.dev tyto prostředky přeloží; o tom, který balíček, tabulku, jazyk a variantu uživatel uvidí, nadále rozhodují Xcode a samotná aplikace.
Použijte formát, který projekt už načítá. Katalogy řetězců uchovávají několik jazyků v jednom souboru .xcstrings, zatímco prostředky .strings a .stringsdict používají pro každý jazyk samostatný soubor. Tento rozdíl určuje, kam se výsledek zapíše a co je třeba při aktualizaci chránit.
Určete, které prostředky jsou směrodatné #
U projektu s katalogy řetězců určete vývojový jazyk, podporované cílové jazyky a katalogy, které aplikace načítá. Xcode 15 přinesl formát .xcstrings, obvykle se souborem pojmenovaným Localizable.xcstrings. Texty lze rozdělit do více katalogů podle funkcí nebo balíčků; zahrňte všechny katalogy, ze kterých lokalizovaná obrazovka čerpá.
U starších prostředků určete příslušné adresáře .lproj, tabulky řetězců a slovníky pro tvary množného čísla. Base.lproj může obsahovat základní prostředky rozhraní; samotná jeho přítomnost ale překladači neříká, který zdrojový jazyk nebo tabulku řetězců má použít. Nastavení vývojového jazyka projektu musí být v souladu s konfigurací souborů.
Před překladem propojte texty na obrazovce s voláními pro načítání lokalizovaných řetězců. Překlad souborů nenahradí texty rozhraní zapsané přímo v kódu ani nepřiřadí prostředky k cíli v Xcode. Zachovejte komentáře, které při kontrole objasní, kdo mluví a na jaké obrazovce. Stávající obslužná rutina pro katalogy řetězců tyto komentáře zachovává, ale nepřidává je ke kontextovým vodítkům překladových jednotek. Nezbytný kontext pro generování proto uveďte v pokynech, které lokalizační engine podporuje.
Nakonfigurujte sdílený katalog řetězců #
V kořenovém adresáři projektu nainstalujte aktuální verzi CLI a proveďte propojení:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr --files 'App/Localizable.xcstrings' --yes
lingo linkPro katalog na této cestě by výsledný .lingo/config.json měl vypadat takto:
{
"orgId": "org_...",
"engineId": "eng_...",
"sourceLocale": "en",
"targetLocales": ["es", "fr"],
"files": [{ "pattern": "App/Localizable.xcstrings" }]
}Ponechte identifikátory vygenerované při propojení, nekopírujte zástupné hodnoty. Přípona určuje použití xcode-xcstrings. Každý cílový jazyk se zapisuje do katalogu na stejné cestě: přidají se položky daného jazyka a zdroj i ostatní jazyky zůstanou zachované. Samostatný targetPath není pro tento formát se sdíleným souborem platný.
Zdrojová hodnota je součástí sdílené struktury:
{
"sourceLanguage": "en",
"strings": {
"Welcome": {
"comment": "Greeting on the signed-in home screen",
"localizations": {
"en": { "stringUnit": { "state": "translated", "value": "Welcome" } }
}
}
},
"version": "1.0"
}Po překladu hledejte položky požadovaných jazyků vedle en. Obslužná rutina podporuje i koncové uzly zdrojových variant pro množná čísla a zařízení a přeskakuje položky označené shouldTranslate: false. Pokud položka nemá zdrojovou lokalizaci, použije se jako zdrojový text její klíč; technický klíč však zamýšlené sdělení nenahradí. Dokument Katalogy řetězců Apple vysvětluje tato pravidla výběru i to, proč musí aktuální zdroj zůstat v souladu se stávajícím katalogem.
Starší soubory uchovávejte na samostatných cestách #
U staršího projektu použijte místo položky sdíleného katalogu tyto položky souborů:
[{ "pattern": "App/en.lproj/Localizable.strings" }, { "pattern": "App/en.lproj/Localizable.stringsdict" }]Zahrňte jen prostředky, které projekt skutečně obsahuje. Přípony určují příslušné obslužné rutiny; výstup ve španělštině patří do App/es.lproj/. Nastavení vývojového jazyka projektu musí odpovídat tomuto výběru zdroje.
Klíče řetězců a formátovací zástupné symboly jsou součástí pravidel, na která aplikace za běhu spoléhá. Zachovejte %@, poziční argumenty i typy očekávané volajícím kódem. .stringsdict obsahuje strukturu proměnných pro množná čísla, která musí odpovídat příslušnému formátovacímu řetězci. Konkrétní požadavky obou formátů najdete v dokumentech Řetězce Apple a Slovníky řetězců; nepřistupujte k nim jako k libovolnému XML nebo textu.
Přeložte a zkontrolujte sloučený výsledek #
Před nahrazením uchovejte aktuální katalog ve správě verzí nebo v samostatné kopii. Chcete-li ochránit ruční úpravy, odešlete překladovou úlohu bez --wait a před stažením zkontrolujte lingo pull --dry-run. Případné rozdíly vyřešte, místo abyste vynutili přepsání. Zpětný zápis při čekání na výsledek neprovádí na rozdíl od příkazu pull novou kontrolu konfliktů; viz Zachování zkontrolovaných překladů.
Pro první překlad bez konfliktů použijte následující příkaz jen tehdy, pokud se katalog během čekání nezmění. Než do stávajícího projektu přidáte jazyky, dokončete běžné aktualizace zdroje pro stávající jazyky a výsledky stáhněte a zkontrolujte. Při následném přidávání jazyků a doplňování překladů už tuto revizi zdroje neměňte. Požadované pořadí vysvětluje dokument Přidání jazyka:
lingo push --backfill-missing --waitU sdílených katalogů probíhá plánování pro každý jazyk zvlášť, i když soubor už existuje. Kontrolujte položky požadovaných jazyků, nehledejte nový soubor. Samotný první push může nastavit výchozí stav zdroje, aniž by spustil překlad. Po běžných změnách zdroje použijte lingo push --wait; pokud na výsledek nečekáte, stáhněte zaznamenaný výsledek pomocí lingo pull ve stejném checkout, ze kterého jste úlohu odeslali.
Chcete-li opravit formulaci, upravte cílovou položku v Xcode. Příkaz CLI --force může i nadále znovu použít překlady uložené v nezměněném katalogu. Pokud chcete po změně pokynů znovu vygenerovat jednu položku, použijte postup opravy katalogu, který zachová zdroj i okolní překlady.
lingo purge přeskakuje katalogy řetězců, protože jejich zdroj i cílové jazyky sdílejí stejnou cestu. K opětovnému vygenerování vybraného překladu použijte workflow pro opravu katalogu řetězců.
Ověřte výsledek v Xcode a na reprezentativních obrazovkách #
Otevřete výstup v Xcode a zkontrolujte, že katalog nebo starší soubor patří do zamýšleného cíle a balíčku. Sestavte aplikaci pomocí stávajícího schématu projektu. Spusťte ji v konfiguraci s cílovým jazykem a zkontrolujte obrazovku s jednoduchým popiskem, formátovanou hodnotou a variantou pro množné číslo nebo zařízení.
Porovnejte zástupné symboly v cílovém jazyce s volajícím kódem. Vyzkoušejte počty, které v jednotlivých jazycích vyvolají různé tvary množného čísla; anglické kategorie nepokrývají požadavky všech cílových jazyků. Ověřte, že ve sloučeném katalogu zůstaly i jazyky, které se neměnily. Zkontrolujte dlouhé popisky, texty pro zpřístupnění, ořezávání textu a tam, kde je to relevantní, i zobrazení zprava doleva.
Kontroly při sestavování v Xcode mohou odhalit problémy s prostředky; význam ověří jazyková kontrola nebo vhodné měření. lingo check nepotvrzuje úplnost .xcstrings ani správné fungování množných čísel podle pravidel Apple.
Zajistěte, aby automatizace zachovala sdílený soubor #
Uchovávejte zdroje, schválené cílové překlady, konfiguraci a .lingo/lock.json společně. Pro opakované úlohy pak zvolte GitHub App nebo běhové prostředí CI. Běhové prostředí si spravuje vlastní ověřování, stav i zpětný zápis, který lze zkontrolovat. Rozdíly v katalogu řetězců posuzujte jako změnu sdíleného souboru: před přijetím ověřte revizi zdroje a určete, které jazyky se změnily a které zůstaly zachované.
U multiplatformních projektů použijte samostatná workflow pro Android a Flutter, která řeší kvalifikátory XML a generování ARB. Každá platforma i tak vyžaduje vlastní kontroly načítání prostředků a vykreslených obrazovek.