Zdroje Androidu

Překládejte podporované řetězce, pole a tvary množného čísla se zachováním názvů zdrojů Androidu a pravidel pro jazykové adresáře.

Android propojuje zobrazovaný text s kódem aplikace pomocí názvů zdrojů. Obslužný modul souborů android tyto názvy zachovává a překládá podporované řetězce, položky polí řetězců a tvary množného čísla v kořenovém elementu <resources>. Atributy počtu a pozice v polích nadále určují, které hodnoty Android načte.

Výběr zdrojů #

Soubor zdrojů může obsahovat text určený k překladu i neměnný název produktu:

xml
<resources>
  <string name="checkout_title">Complete your order</string>
  <string name="brand" translatable="false">Acme</string>
  <string-array name="delivery_methods">
    <item>Standard delivery</item>
    <item>Express delivery</item>
  </string-array>
  <plurals name="items">
    <item quantity="one">%d item</item>
    <item quantity="other">%d items</item>
  </plurals>
</resources>

Názvy zdrojů, pozice v polích a kategorie počtu u tvarů množného čísla určují hodnoty určené k překladu. brand se přeskakuje, protože má translatable="false". Součástí identity položek pole je i jejich pozice, takže změna pořadí ovlivní přiřazení textu k existujícímu překladu. Aktuální verze CLI nepodporuje výběr --key pro Android; místo toho vybírejte celé zdrojové soubory.

Obslužný modul čte znaková data z každé položky a přeskakuje položky s podřízenými elementy, například <b> nebo <xliff:g>. Zkontrolované překlady těchto zdrojů s formátovaným obsahem dodejte samostatně a po dokončení zbytku souboru ověřte, zda jsou pokryté všechny. Text kolem vloženého komentáře XML se pro překlad spojí. Nahrazení hodnoty může tento komentář odstranit; jeho znění se nepoužívá jako vodítko pro překlad.

CDATA se zpracovává jako text, pokud tvoří jedinou textovou hodnotu, a při rekonstrukci se zachová její obal. Značky uvnitř CDATA jsou součástí textu odesílaného k překladu, nikoli chráněnou strukturou podřízených elementů. Tyto zdroje ověřte pomocí kódu, který aplikace skutečně používá k vykreslování.

Umístění jazykových verzí #

Zdrojem bývá res/values/strings.xml; německý překlad patří do res/values-de/strings.xml. Kvalifikátory regionu a písma musí odpovídat zápisu Androidu, například values-pt-rBR nebo values-b+zh+Hans. Nestačí za values- vložit libovolné označení jazyka.

CLI při odvozování cest rozpozná samotný adresář values, pokud je výslovně nastaven formát Android. Pro toto podporované uspořádání není nutné vytvářet pomocný symbolický odkaz values-en. Zápis jazyka pro Android vyplývající z formátu i případná explicitní cílová cesta patří do konfigurace CLI. Než výstup přijmete, zkontrolujte odvozenou cestu.

Opětovné použití a částečný výstup #

Předchozí zdrojový text se porovnává podle identity zdroje. Při rekonstrukci se odpovídající hodnoty přebírají z existujícího překladu. Při změnách zdroje používejte běžné lingo push --wait a před vynucenou aktualizací celého souboru si uchovejte schválené překlady. Neměnný text patří do zdrojů označených translatable="false"; lockedKeys v CLI neslouží k řízení zdrojů Androidu.

Obslužný modul zachovává kategorie množného čísla ze zdroje. Nezaručuje však úplnou sadu kategorií ani správné znění pro každý cílový jazyk. Otestujte počty a formátované proměnné pomocí mechanismu, kterým aplikace načítá zdroje.

Nastavení a ověření zdrojů Androidu #

Pro zdroje .xml v CLI výslovně nastavte format: "android". Samotné XML nestačí k rozpoznání sady elementů a atributů zdrojů Androidu. Nakonfigurovaný typ podporuje také GitHub App.

Sestavte načtené zdroje pomocí nástrojů Androidu a pak otevřete obrazovku, která používá řetězec, pole a tvar množného čísla. Celé workflow dokončíte podle návodu Lokalizace aplikace pro Android. lingo check hlásí změněný zdroj nebo chybějící cílový soubor, nikoli chybějící zdroje Androidu uvnitř souboru.