Katalogy řetězců Apple

Aktualizujte hodnoty v cílovém jazyce přímo v katalogu XCStrings a zachovejte přitom zdrojový jazyk i ostatní jazyky.

Katalog .xcstrings uchovává zdrojový text i jeho překlady pohromadě. Obslužná rutina pro soubory xcode-xcstrings doplňuje položky v cílovém jazyce přímo do katalogu a ostatní jazyky ve stejném souboru zachovává. Výsledkem je upravený katalog na cestě ke zdrojovému souboru, nikoli nový soubor pro každý jazyk.

Zdrojové hodnoty a varianty #

Položka s výslovně uvedenou anglickou zdrojovou hodnotou vypadá takto:

json
{
  "sourceLanguage": "en",
  "strings": {
    "checkout.title": {
      "localizations": {
        "en": {
          "stringUnit": {
            "state": "translated",
            "value": "Complete your order"
          }
        }
      }
    }
  },
  "version": "1.0"
}

Text se přebírá z stringUnit.value ve zdrojovém jazyce. Podporované varianty množného čísla nebo varianty pro různá zařízení poskytují samostatné koncové hodnoty, z nichž každá má vlastní identitu podle dané varianty. Pokud položce chybí zdrojová lokalizace, použije se jako zdrojový text její klíč. Tento náhradní postup se hodí pro klíče tvořené zdrojovým textem. Technický klíč, například checkout.title, ale zamýšlené anglické sdělení nenahradí.

Položka s shouldTranslate: false se přeskočí. Komentáře katalogu mohou ve sdílené struktuře zůstat. Nápovědy obslužné rutiny ale určují formát a variantu; nelze z toho vyvozovat, že se každý komentář použije jako pokyn pro překladatele.

Úplnost se posuzuje pro každý jazyk zvlášť #

Úplnost se kontroluje v rámci požadovaného jazyka. Obslužná rutina vybírá podporované zdrojové položky, které se změnily nebo nemají cílovou hodnotu. Překlady tak lze doplnit i pro nový jazyk, přestože sdílený katalog už existuje.

Překlady uložené v katalogu lze znovu použít i s volbou CLI --force. Vymazáním samostatného cílového vstupu se hodnoty ve zdrojovém katalogu neodstraní. Pokud potřebujete změnit znění překladu, aniž by se změnilo zdrojové sdělení, postupujte podle návodu k opravě níže.

Sestavování vychází z aktuálního zdrojového katalogu. Tam, kde je to relevantní, přebírá stávající jazyková data jeho položek a zapisuje požadované překlady do aktuálních položek a variant. Zkontrolujte celý přehled změn sdíleného souboru, včetně změn zdroje i jazyků, které se neměnily. Nové cílové jednotky dostávají stav translated; o jejich přijetí člověkem se rozhoduje samostatně při kontrole.

Struktura variant množného čísla a variant pro zařízení vychází z podporovaných koncových zdrojových hodnot. Nepředpokládejte, že byly vygenerovány nebo ověřeny všechny gramatické tvary každého cílového jazyka. Projděte sadu variant a ověřte zobrazení reprezentativních případů v aplikaci.

Nastavení výstupu do sdíleného souboru #

CLI odvodí xcode-xcstrings z .xcstrings a zapíše výstup na cestu ke zdrojovému souboru. Konfigurace u tohoto typu nepovoluje samostatné targetPath. Postupujte podle stručného průvodce prací se soubory v CLI až po stažení výsledků, nebo pro spravovaný překlad repozitáře použijte GitHub.

Oprava stávajícího překladu #

Pokud chcete znění opravit na konkrétní podobu, upravte hodnotu pro daný jazyk v Xcode a ověřte ji v aplikaci. Chcete-li překlad znovu vygenerovat po změně pokynů pro engine, nejprve dokončete rozpracované překladové úlohy a uchovejte celý katalog. Zachovejte stávající výchozí stav CLI a zahrňte požadovaný jazyk do targetLocales.

Odstraňte pouze cílovou položku, kterou chcete znovu vygenerovat. Ve výše uvedeném příkladu s němčinou jako cílovým jazykem jde o strings["checkout.title"].localizations.de; zachovejte en, ostatní jazyky i sousední položky. Soubor uložte a poté spusťte běžné přírůstkové odeslání:

sh
lingo push --wait

Upravený katalog se odešle bez dané cílové položky, takže vybraná položka bude vyžadovat překlad. Během čekání soubor neupravujte. Před přijetím zkontrolujte novou německou hodnotu i celý přehled změn katalogu. U položky s variantami množného čísla nebo variantami pro zařízení se odstraněním záznamu pro daný jazyk znovu vygenerují všechny její podporované zdrojové varianty.

Tento postup použijte s uloženým výchozím stavem a běžným odesláním. Poziční vzory, --backfill-missing a --key vybírají jiné úlohy; purge sdílený soubor přeskočí.

Kontrola všech změn katalogu #

Před nahrazením nebo vyčištěním katalogu uchovejte jeho verzi uloženou v repozitáři nebo lokální kopii. Příkaz purge v CLI tento formát přeskakuje, protože zdroj i výstup sdílejí stejnou cestu. Pokud chcete znovu vygenerovat jeden překlad, odstraňte záznam pro příslušný jazyk podle výše uvedeného postupu.

Kontroly katalogu v CLI nepotvrzují úplnost jednotlivých jazyků v XCStrings. V Xcode a při kontrole aplikace ověřte zařazení prostředků, vývojový jazyk, práci s více katalogy, zástupné symboly a zobrazované varianty. Tento workflow popisuje průvodce Lokalizace aplikace pro iOS. Starší formáty strings a stringsdict nadále pracují se samostatnými soubory pro jednotlivé jazyky.