アンドロイドのリソース
アンドロイドのリソース名とロケールディレクトリの規則を保ちながら、対応する文字列、配列、複数形を翻訳します。
アンドロイドでは、リソース名で画面に表示するテキストとアプリケーションのコードを結び付けます。androidファイルハンドラーはリソース名をそのまま保持し、<resources>ルート内の対応する文字列、文字列配列の項目、複数形の項目を翻訳します。アンドロイドが読み込む値は、引き続き数量属性と配列内の位置によって識別されます。
リソースの選択#
リソースファイルには、翻訳対象のテキストと、翻訳しない固定の製品名を混在させられます。
<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>翻訳対象の値は、リソース名、配列内の位置、複数形の数量で識別されます。brandはtranslatable="false"が指定されているため、処理の対象外です。配列の識別情報には位置も含まれるため、順序を入れ替えると、テキストと既存の訳文との対応関係が変わります。現在のCLIは、アンドロイドの--keyによる選択には対応していません。代わりにソースファイル全体を選択してください。
ハンドラーは各項目の文字データを読み取り、<b>や<xliff:g>などの子要素を含む項目は処理しません。こうした装飾付きリソースには、レビュー済みの訳文を別途用意し、ファイル全体の処理が完了した段階で翻訳の網羅状況を確認してください。インラインのXMLコメントの前後にあるテキストは、結合して翻訳されます。値を置き換えると、そのインラインコメントが削除される場合があります。コメントの文言は翻訳のヒントには使われません。
CDATAが単一のテキスト値を構成する場合は、テキストとして解析され、再構築時にも囲みの構文が保持されます。CDATA内のマークアップは、保護される子要素の構造ではなく、翻訳に送られるテキストの一部として扱われます。これらのリソースは、アプリケーションで実際に使う描画コードで確認してください。
ロケールごとの配置#
通常、ソースはres/values/strings.xmlに、ドイツ語の翻訳先はres/values-de/strings.xmlに配置します。地域や文字体系の修飾子には、values-の後に任意のロケール文字列を付けるのではなく、values-pt-rBRやvalues-b+zh+Hansのようにアンドロイドの表記規則に沿ったものを使う必要があります。
CLIのパス導出は、アンドロイド形式を明示的に指定した、修飾子のないvaluesディレクトリに対応しています。この構成では、便宜的にvalues-enシンボリックリンクを作る必要はありません。形式によって暗黙に決まるアンドロイドのロケール表記や、明示的な翻訳先パスは、CLI設定で指定します。出力を採用する前に、導出されたパスを確認してください。
再利用と部分的な出力#
以前のソーステキストは、リソースの識別情報に基づいて比較されます。再構築時には、既存の翻訳先から対応する値が取り込まれます。ソースの変更には通常のlingo push --waitを使い、ファイル全体を強制更新する前に、承認済みの訳文を保存してください。翻訳しない固定テキストは、translatable="false"を指定したリソースに配置します。CLIのlockedKeysは、アンドロイドのリソースを制御するものではありません。
ハンドラーはソースの複数形カテゴリを保持します。ただし、すべての翻訳先ロケールで必要なカテゴリがそろうことや、文言が正しいことを保証するものではありません。アプリケーションのリソースローダーを使い、数量と書式付き変数をテストしてください。
アンドロイドのリソースの設定と検証#
.xmlのCLIソースでは、format: "android"を明示的に設定してください。XMLだけでは、アンドロイドのリソースで使われる語彙を識別できません。GitHub Appでも、設定した種別を使用できます。
取得したリソースをアンドロイドのツールでビルドし、文字列、配列、複数形を使う画面を開いてください。ワークフローの仕上げについては、アンドロイドアプリのローカライズを参照してください。lingo checkが報告するのは、ソースの変更や翻訳先ファイルの欠落であり、ファイル内のアンドロイドリソースの欠落ではありません。